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PREFACE 

This DOS.C SYSTEMS GUIDE is written to aescribe the specific 
characteristics of Datapomt Corporation DOS.C, supporting 1100, 
2200 ana 5500 computers with the 93b0-series diskette drives. 
This manual is intended as strictly supplementary to the DOS 
USER'S GUIDE, with which the reader is assumed to be familiar. 

It IS important to realize that the DOS characteristics 
documented in this manual are here precisely because they are 
different in the DOS.C implementation than for certain of the 
other Datapomt Corporation DOS; as such, programs written msed 
on features documented herein and not documented m the DOS USER'S 
GUIDE will not be as easily transportable to other versions of the 
DOS. 



CHAPTER 1. INTRODUCTION TO DOS.C 



DOS.C IS Datapoint Corporation's Disk Operating System 
supporting Datapoint 1100, 2200 and b500 computers operating m 
conjunction with up to four 93b0 series diskette drives. 

1.1 Planning for DOS.C 

The recommenaed configuration for a DOS.C system includes 16K 
of memory m the 1100 or 22 00 series computers and 16K or more m 
5b00 series computers. Use of a single 9380~series drive is 
possible, JDUt the user should at least have access to a 
double-drive system for backup purposes. Some consideration must 
be given to the question of copying files from one diskette to 
another. Users with 22u0 and 5500 series computers (having 
cassette tape drives) cdn use cassettes it necessary as a standard 
exchange medium for file transfers (except for files bigger than 
about 450 sectors, too large to fit on a single side of a 
cassette). Users with Diskette 1100 series computers do not have 
cassette tape drives and hence must use diskettes as their file 
transfer medium. Since DOS.C software is distributea on diskettes 
by Datapoint Corporation, the user will need to have at least a 
two arive system to copy the software from the diskette received 
from Datapoint to his working diskette ( s) . Single arive systems 
shoula De considered only oy users intending to use them as 
satellite systems (example: data entry stations) and planning on 
having at least one other system with two or more drives (for 
program development ana file processing applications). 

Another option which should be strongly consiaered is the 
High Speed, or so-called -RAM-' Display option. This option can 
substantially increase total system throughput and responsiveness 
(especially m applications displaying a lot of text on the 
screen, such as data entry) at a very small aduitional cost- The 
RAl^i Display IS field-installable (although less expensive when 
factory-installed), and is stanaard equipment on Datapoint 5500 
ana Diskette 1100 series computers. 

1.2 Performance of DOS.C 

Users who are currently using Datapoint computers m 
cassette-based systems will find substantial improvements m 
performance when they upgrade to DOS.C The 93 80 series diskette 
drives are several times faster than cassettes for ordinary 
sequential data transfers; random-access type operations (such as 
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sorting and ISAM file access) can easily be two orders of 
magnitude faster than is attained using tape cassettes. 

^^n ^^^^f^ ^i"? ^""^ currently using competitive diskette-based 
Datanmnt It I ^^"^^t^l^ ^^"^ that total system performance of 
Datapomt systems will exceed that which they are accustomed to. 
This improvement is due to the generally superior data handling 
techniques and file structuring as used m Datapomt' s DOS. ?hese 

?nw^^''^^''i^^'-^^ ^^^"^ ^^^^ ^^^ f^^t th^t instead of employing a 
lower-performance cassette-style file structure as a base for the 
operating system, Datapomt chose instead to adapt the same 
nth.r^tn^^r dynamic disk file access techniques as used m its 
other DOS to the new diskette media. The result is a degree of 
software sophistication previously unavailable m 
busmess-oriented systems of this size. 

The obvious side benefit of this DOS compatibility is that 

not only is virtually all of the Datapomt DOS software library 

available to diskette users but that most user programs which were 

written originally for other Datapomt DOS systems will run 

diff^rf^nL^f ""T ^K^ Possible file size limitations and timing 
differences due to the slower access times of the 93b0 series disk 
drives) under DOS.C 

In addition to the increased speed of access to the 9380 
^hf^^^K^^'^rrn^^ compared to cassettes, another big advantage is 
that the total amount of storage available on a diskette-based 
system IS about four times the amount usable on cassette systems, 
even when both cassette drives are in use. systems. 

It should be recognized that is DOS.C is not expected to 
^!ovf M usefulness of larger capacity, higher performance 
disks. Many users will have applications which are too involved 

or too large for the 9380 s^r^noc ri-, ov^^-4-p ,.^,.,^^ r, .., 

very large data files or very high speed random access to disk 
storage will fmd the performance they are looking for in the 
other versions of Datapomt DOS. 
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CHAPTER 2. DISK DRIVES 



Datapoint DOS.C supports up to four 9380-series flexible 
diskette drives through their integral disk controller unit. The 
disk controller contains 1024 bytes of high speeds random access 
memory which buffers four sectors between the disk drives and the 
Datapoint computer, enabling greater I/O device autonomy and 
improved overall system performance. 

2.1 Disk media 

The Datapoint 9380~series flexible diskette drives use a 
flexible diskette for data storage. This diskette is media and 
format-compatible with the IBM 3741-style flexible diskette- 

Data IS recorded m 77 concentric circles on only one side of 
the diskette (as per the IBM standards for diskette data 
interchange). Each such circle is referred to as a track . 
Although each such track on the diskette actually contains 26 
physical records of 128 bytes each, these are paired up by the 
Datapoint 93b0 series diskette controller (an integral part of the 
diskette system) so that to the Datapoint computer each track 
appears to consist of 13 records (called sectors ) of 256 bytes 
each. In Datapoint DOS documentation/ unless explicitly indicated 
to the contrary, the term sector always refers to a 256-byte 
logical sector, and it is strictly incidental that this sector is 
broken into two physical 12b byte records for transfer to and from 
the diskette media. 

The diskette is permanently enclosed withm a durable plastic 
cover. This cover provides for easy insertion of the diskette 
into the diskette drives and provides structural rigidity for the 
media when it is not m use. In addition, the plastic cover 
proviaes a degree of environmental protection for the diskette and 
Its oxide surface from damage caused by careless handling. 

2-2 Loaumg and unloading diskettes 

Upon observation of a diskette, three holes through the 
plastic diskette cover will be noted. Each of these holes allows 
one to see a portion of the oxide-coated surface of the diskette 
itself. 

The large, round hole m the center of the cover is used by 
the diskette drive for the hub which clamps to the diskette and 
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turns the diskette withm the cover. 

The longer, narrower radial slot towards one edge of the 
enclosure is the slot through which the read/write head m the 
diskette drive contacts the diskette's oxide coating for data 
transfer operations. 

The smaller round hole present on the diskette is the hole 
through which the index hQl&, a hole in the diskette proper about 
the diameter of a pencil lead, is sensed by the controller and 
used for timing and control purposes. 

The reason for the description of these holes is that they 
provide the definitive reference for indicating the proper 
direction of insertion of the diskette media into the 9380 series 
drives. When the diskette is properly inserted, the edge of the 
diskette with the long slot is inserted first. The smaller hole 
(the one through which the index hole is sensed) will be the last 
of the three holes m the cover to enter the drive, and it will be 
positioned toward the tabletop rather than downwards toward the 
floor. 

The diskette loading slot is covered by a long, narrow 
handle. A rectangular pushbutton to the side of the handle is 
pushed to open the handle for diskette insertion and removal. 
When inserting the diskette, it will meet with a spring resistance 
after being inserted about 3/4 into the drive. Press the diskette 
gently into place until the spring catches and the diskette stays 
m place without being held m with the finger. Be careful not to 
push the diskette too far into the drive, as this can cause the 
innermost edge of the diskette's plastic cover to be wedged 
oetween some metal projections on the diskette drive which could 
possibly result m damage to the diskette. After the diskette is 
m place, pull the door/handle to the left until it latches 
closed. As the door is pulled closed, the hUD engages the 
diskette, bringing it to its rated rotational speed of 360 rpm 
(and then online) almost immediately. 

To remove a diskette, first ensure that all input/output 
activity on the diskette has quiesced. (This is necessary since 
It is possible to open the drive door, which takes the diskette 
offline, in the middle of a write operation; this can result in 
improper data being written onto the diskette). Then press the 
Dutton to the left of the door/handle. The door will open and the 
diskette will emerge m much the same way toast pops out of a 
toaster. Upon removing the diskette from the drive, it should be 
immediately placed in its protective paper envelope to help 
protect the surface from abrasive contaminants and other elements 
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which coula damage it- 

2.3 Drive numJDering and switches 

Diskette drives are normally installed m the cabinet 
starting from the left. These drives are numbered 0, 1, 2, and 3 
respectively from left to right. These numbers constitute the 
Physical 0rive number* in the case of DOS.C, the same number is 
also sometimes referred to as the DOS logical drive number , or 
frequently just drive number . 

The main power switch for the diskette unit is located on the 
underside of the tabletop and to the left side of the diskette 
drives, positioned toward the front of the cabinet. Sliding this 
switch towards the rear of the diskette drive cabinet turns the 
diskette unit on, and sliding the switch towards the user turns 
the diskette unit off. This switch should normally always be left 
m the OInI position. 

There are no other controls or switches intended for use by 
the user on the y380-series diskette drives. 

2.4 Care and handling of diskettes 

Diskettes are sturdy media which will give long and 
trouble-free service if they are handled with reasonable care- 

1) Diskettes should always be stored m their protective 
paper envelopes when not inserted m a drive. These envelopes 
should then be stored m the protective boxes m which the 
diskettes are received from the manufacturer. 

2) Do not force too many diskettes into one box. They 
should not be placed under heavy pressure, as this can warp the 
diskette media, possibly causing read/write errors. 

3) Diskettes should not JDe rolled, folded or otherwise 
suDjected to strains which could crease the media. 

4) Never touch the oxide coating of the diskette through the 
holes in the plastic cover. The skin has oils on it which will 
attract and retain dust and other abrasive contaminants if these 
oils get onto the diskette's surface. In addition, contact 
between hara surfaces and the diskette oxiae can scrape away the 
information-carrying oxioe from the diskette surface; this will 
usually result m unrecoverable errors on the diskette- 
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Diskettes should not be subjected to strong magnetic 
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fields. 

6) When mailing diskettes, they should either be placed 
Detween two sheets of corrugated cardboard (for rigidity and 
protection while going through the mails) or placed m some 
suitable protective carrier. Many diskette media manufacturers 
sell mailers specifically designed for use in sending diskettes, 
either singly or m multiples, through the mail. 

7) Diskettes can generally be taken through airport security 
x-ray and metal detecting equipment without danger of damage to 
the information recorded on the diskette. 

2.5 Preparing diskettes for use 

When a diskette is first received from the media 
manufacturer, it contains formatting information recorded across 
the entire usable surface of the diskette. This information is 
provided to allow the controller to identify where a given sector 
IS on the surface of the disk, and also allows the controller to 
verify proper head positioning m the drive mechanism. Normal 
reading and writing on the diskette does not destroy the 
formatting information contained thereon. 

Diskettes cannot be used by DOS.C until they have been 
DOSGENed. (The DOSGEN process is described m the DOS USER'S 
GUIDE). Since the standard IBM file structure on diskettes is 
intended for data entry and not for actual computer aata 
processing, Datapoint DOS uses its own unique file structure which 
IS capable of more sophisticated data and file manipulation. This 
more sophisticated file structure is what results m the need for 
DOSGEN before a diskette can be used by DOS.C 

A special note reaardina ni rVc w>>t«^»^ a*-*^ ■»-^ '^•^ ..r.^^ ,^ ~^-,._ 
zero IS appropriate. Many of the newer releases of DOS commands 
will use DOS FUNCTIONS (as described in the DOS USER'S GUIDE) m 
increasing numbers. These functions are resident on the diskette 
m the file SYSTEM7/SYS. When updated versions of DOS.C and 
associated utilities are received from Datapoint Corporation, the 
file SYSTEM7/SYS may also have one or more new DOS FUNCTIONS 
resident. Therefore, wholesale copying of DOS commands from newly 
received diskettes to olaer aiskettes with older versions of 
SYSTEM7/SYS will frequently result m commands which either work 
or ao not work depending on whether the older or newer version of 
SYSTEiyi7/SYS is present on the disk m drive zero. Therefore the 
user should generally keep his DOS commands disk more or less 
intact and not use a newly released diskette to supply commands to 
previously DOSGENed diskettes; instead, he should freshly 
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generate as many system diskettes (including whichever DOS 
commanas he intends to use) as he needs. 

2.6 Suggested aisk organization techniques 

Due to the relatively small capacity of the flexible 
diskette, careful consideration should JDe given to which files 
shoula i3e put on which diskettes. Users with single drives for 
data entry and relatea applications will have little choice m 
such matters. However, for users with multi-drive systems being 
usea for program development, the following convention is 
suggested: 

1) DOS system diskettes. These diskettes contain the system 
files (as do all diskettes for use with DOS.c) and whichever DOS 
commanas the user intends to use. Usually this aiskette will oe 
used m drive zero during program generation, debugging and other 
DOS system-type functions and because of this will contain all of 
the DOS, DOS commands and latest set of DOS FUISiCTIOInIs as released 
by Datapomt. This diskette will also frequently contain the 
editor scratch file, SCRATCH/TXt 

2) Source program diskettes. These diskettes can be 
considered as library file diskettes. These diskettes contain 
programs, Dataform forms, and other user text files used, for 
example, during program generation. Once these programs are 
finalized, they can be copied to DOS System diskettes or User 
System diskettes as appropriate. 

3) User system diskettes. These diskettes are similar m 
intent to DOS System diskettes but differ in that they are 
intended more for specific application use rather than for general 
program development and debugging. These diskettes will usually 
be usea with Databus 1100, Scribe, DOSBASIC, or Dataform and/or 
have large numbers of user-written application programs on them. 
These aisks will usually not contain the more specialized DOS 
commands (and other files) such as DUMPySSO, REPAIR, DOS/EPT, 
MASSACRE, APP, CHAISIGE , DUMP and the like. 

4) Data file diskettes. These diskettes contain primarily 
user data files. Typical characteristics of files on this type of 
diskette: non-executable, user information; SCRIBE text; other 
things which are user-enterea (or generated) but not programs as 
such. 

5) Scratch diskettes^ These diskettes are diskettes 
containing no important files. These diskettes are suggested for 
use m transferring files from one diskette to another, ana to 
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provide diskettes containing large unallocated areas for use as 
scratch files by programs using scratch files (for example, SORT 
and EDIT commands). 

As support for the above five basic types of diskettes, the 
following color-coding convention is suggested for diskette 
labels: 

red - DOS System diskettes 

green - User System diskettes 

blue - Text files (source programs and SCRIBE text) 

yellow - Data files 

grey - Scratch diskettes 

For best results, users should use only diskette media 
provided by those manufacturers recommended by Datapomt 
Corporation. 
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CHAPTER 3. THE DUMPy380 COMMAND 



The DUMP93 80 comniand enables the programmer to inspect, 
record, or loaa physical disk sectors. DUMP9380 is intended to be 
a working partner of the DEBUG facility in the debugging and 
monitoring of programs running under the DOS. 

3.1 Use 

DUMP93bO can be invoked from an active DOS by keying m at 
the system console: 

DUMPi^3bO 

Since DUMPy3bO is a completely self-contained program, it can 
be run from an LGO cassette tape (unlike most DOS comniands which 
rely on one or more of the DOS routines for their execution). In 
this mode, DUMP9380 can occasionally be useful in helping to 
determine the problem when the DOS will not boot up from some 
pack. If a user intends to use DUMPy3B0 in this way, he should 
take care to make an LGO tape and store it safely away somewhere, 
before he needs it. 

DUMPS»3tJ0 can output physical disk records (sectors) to a 
local printer, the cassette deck, or to the screen, and can load 
sectors to disk from the cassette deck. 

There are two command handlers in DUMPy380. The primary 
command handler controls all DUMPy3 80 functions except the screen 
dump. The screen dump requires its own syntax because it is an 
interactive, and more flexible, facility. 

All commands to DUMP 9 3 80 employ the same conceptual 
structure, though elements of commands may be implicit as well as 
explicit. The full explicit format for commands is: 

X AAA,BBB CCCDDD 

where X is the command 

AAA IS the starting cylinder number 

BBB IS the starting sector on that track 

CCC is the ending cylinder number 

DDD IS the ending sector on that track 

The FlexiDle Diskette operating system uses a skewed logical 
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sector addressing scheme. Disk addresses used throughout DUMP93bO 
are the logical address unless EBCDIC mode is Demg used. 

The command codes of the primary command handler are: 

P Print on the local printer 

S Screen dump 

CD Cassette dump 

CL Cassette load 

# Jump to D.O.S. DEBUG 

'*' Return to D.O.S. command interpreter 

A ASCII mode (for printer or screen dump) 

E EBCDIC mode (for printer or screen dump) 

Octal mode (for printer or screen dump) 
f Physical drive numlDer 

The command codes of the screen dump command handler are: 

# Return to the DDUMP primary command handler 

# Jump to D.O.S. DEBUG 

1 Increment the (cylinder, sector ) address 
D Decrement the (cylinder , sector ) aadress 
C Cylinder aadress mode 

S Sector address mode 

A ASCII display mode 

E EBCDIC uisplay moae 

Octal display moae 

The following operating instructions discuss the commands and 
their applications/ with some examples, in more aetail. 

3.2 The primary command handler 

As soon as DUMpySdO has fully loaded, it displays its signon 
message on the screen. When the cursor appears at the lower left 
corner of the screen the primary command handler is ready to 
accept commands. 

3.3 Using DUMPi^3bO with a local printer 

P - Print on the local printer 

DUMP9370 will print only to a local printer, address 0303. 
The 256 JDyte disk records (sectors) are listed 32 i^ytes per line, 
b lines per sector. Preceding each b line clock of print is a 
short line giving the logical (or physical if in EBCDIC mode) disk 
address of the printed sector. One sector or the entire disk may 
be dumped to the printer by a P command. After the last sector is 
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printed the page is ejected to top of the next page. 

Unless otherwise specified, the bytes are printed m octal, 
with a space separating each byte, except every eighth byte is 
delimited by a period. If the DUMP9380 command is m the ASCII 
mode (set with the A command) characters that are valid ASCII 
characters will be printed in ASCII. Lower-case ASCII alphabetic 
characters are indicated by a preceding underscore (_) . If the 
DUMP93 80 command is m the EBCDIC mode (set with the E command) 
characters that are valid EBCDIC characters will be printed m 
EBCDIC. Lower-case EBCDIC alphabetic characters are indicated by 
a preceding underscore (_) . 

COMMAND EXAMPLES J 

P 000,000 000,000 



uld dump to the printer the disk records from cylinder 000, 
^^ctor 000, thru cylinder 000, sector 000. In other words, print 
only the one sector with the disk address 000,000. 



wou 
se 



Note from the following examples that the parameter fetching 
subroutine will make certain assumptions about information not 
explicitly given. 

P 0,0 0,14 

would dump to the printer the disk records from cylinder 000, 
sector 000, thru cylinder 000, sector 014» In other words, dump 
to the printer all of the sectors on cylinder zero. Cylinder zero 
is not used by DOS-C and will be m the original EBCDIC format. 
Note that It IS not necessary to supply leading zeros m an 
address. 

POO 

would do exactly the same thing as the previous example. When 
only the first number is given between spaces, it is taken to be a 
cylinder address, with a sector address of 000 assumed for the 
beginning cylinder and a sector address of 014 assumed for the 
ending cylinder address. 

P 4 

would dump to the printer the disk records from cylinder 00 4, 
sector 000, thru cylinder 004, sector 014.. In other words, all of 
the sectors on cylinder 4. When only one cylinder address is 
given, it is taken to be Doth the beginning and ending cylinder 
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address. 

P 48 50,7 

would be assumed to mean: P 048,000 050,007 . 

The contents of logical sector 014 is of special significance 
to the D.O.S. because it contains the two major sets of tables: 
the cluster allocation tables (CATs) and the directory. A special 
case of the P command will aump logical sector 014 to the printer 
m a format that simplifies inspection of the logical sector 014 
tables, especially the directory. There are two copies of each 
table; the master copy of the directory is from track 021 through 
track 040. The backup copy of the directory is from track 01 
through track 020. The master CAT is on track 041, the backup CAT 
IS on track 042, and the lockout CAT is on track 043. The special 
P command will dump one track at a time to the printer. 

P Cx 

would mean Print the Catalog. The "x" may be (print the master) 
or 1 (print the backup). If not given, "x" is assumed to be 
(the master copies of the CAT and directory will be printed). 

The CAT IS dumped m normal octal format (even if ASCII or 
EBCDIC mode is in force). There are sixteen directory entries on 
each sector of the directory, each entry being sixteen bytes long. 
A directory sector is dumped to the printer with four entries per 
line, four lines per sector. Each directory entry is delimited by 
a perioa. The format of a printed directory entry is: 

CCC TTP LSP MSP NNNNNNNNXXX SDN 



where CCC (octal 

P (octal 

TT (octal 

LSP (octal 

MSP (octal 

NNNNNNNN (ASCII 

XXX (ASCII 

SDN (octal 



r-v 1 1 nric»r- ^rirl-rncc o-F +-ho -Filci'c PTP 



IS the protection of the file 

IS the cluster number of the file's RIB 

( left- justified; the most significant three bits) 

is the least significant portion and 

IS the most significant portion of the file's 

old logical length limit field 

IS the 8-character name of the file 

is the 3-character extension of the file 

IS the number of the subdirectory the file is m 



Note that m the NNNNNNNN and XXX fields, any characters that 
are not valid ASCII characters will be printed as question marks 
(?). Since unused directory entries are set to all octal 37 7, 
they will be printed as: 
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377 317 311 311 77?17?7'^7?7 377 

3.4 Screen Display format 

S - Screen dump 

DUMP93B0 can display on the CRT one disk physical record 
(sector) at a time? m octal? ASCII i or EBCDIC f and the address of 
the sector displayed is controlled m a manner analogous to the 
display of bytes m memory by the DOS debugging facility- 

A special display format is utilized to enable all 25 6 bytes 
of a sector to be displayed on the 22 00 screen at one time. Below 
IS a diagram of what a screen dump of a sector would look like; 
given the CYL,SEC address = 44,6 and each byte in the example 
sector IS its location withm the sector; (i.e., starting at the 
beginning of the sector, the bytes are ( m octal) 000, 001, 002, 
003,. . ., 0377: 
44_000001 0020 03004005 00600 7 010011012013 014015016017 02 0021022023 02 4025026027 
006 030031032033034035036037 040041042043044045046047 050051052053054055056057 
Oil 060061062063064065066067 070071072073074075076077 

_1 01 Oil 021 03 1041 051061 07 110111112113114115116117 12012112212312 412 5126127 
13013113213313413513 613 7 140141142143144145146147 15015115215315415515615 7 
160161162163164165166167 170171172173174175176177 
_200201202203204205206207 210211212213214215216217 22 022122222322 4225226227 
2302312322332342352362 37 2402412422432442452462 47 2502 5125225325 425525625 7 
2602612622632642652 66267 27 02 712 7 227 32 7 427 52 7 627 7 
_3003 0130230330430530 63 07 310311312313314315316317 320321322323324325326327 
330331332333334335336337 3403413423 433443453463 4 7 35 035135235335435535635 7 
3603 613 623633643653663 67 3 703 713723 733 743753 763 7 7 

Mote from the diagram that: 

The cylinder (044), physical sector (006), and logical sector 
(Oil) addresses are displayed m the top left corner of the screen. 

Each group of 10 (octal) bytes is displayea m a contiguous 
block of digits. 

Each block of 100 (octal) bytes begins at the left side of the 
screen, preceded by an underscore (_) . 

Each block of 100 (octal) bytes consists of 10 (octal) groups of 
10 (octal) contiguous bytes; 3, 3, ana 2 groups to a screen line, 
for the three lines required to display 100 (octal) bytes. 

The screen displays 400 (octal) bytes, which is one disk 
sector, 2 56(aecimal) bytes. 

To further Dreak down the screen ana enable quick location ana 
reaamg of maividual bytes, the first digit of every second byte 
IS flashea on ana off. Thus, each group of eight bytes is divided 
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into four units of two bytes. 
COMMAND EXAMPLES : 
S 044,011 

would mean: display cylinder 44, logical sector 11 on the 
screen. This command can only be given to the PRIMARY 
COMMAND HANDLER, and after it is executed DUMP9380 will De 
under the control of the SCREEN DUMP COMMAND HANDLER. Note 
that, under the DOS.C disk organization, the sector 
displayed is cylinder 44, physical sector 6, logical sector 
11* 

3.5 The SCREEN DUMP COMMAND HANDLER 

Note that as m the DOS debugging facility, the command 
codes entered are not displayed, the command is merely 
immediately executed. 

Return to the PRIMARY COMMAND HANDLER. The screen will 
be rolled up, the cursor turned on, and keyed commanas 
will be displayed as they are entered at the lower left 
corner of the screen. 

NOTE that the SHIFT key must be depressed at the same 
time as the asterisk (*) key. 

* I^mI^LoS.^^^ ^^^ debugging facility. # will not work if 
DUMP93/0 was loaded from an LGO tape. 
NOTE that the SHIFT key must be depressed at the same 
time as the pound sign (#) key. 

I Increment the cylinder or sector address and display the 

sector Pii- +■ hck r>oT.. 3,^^-,^^«« mu- -. -I- "1- 

^ _„ ^,,^ ,^^„ uMMi-coD. X nv liew uisj^ aaaress will be 

dispiayea at the top left corner of the screen. 

If the C (Cylinder address mode) command is m force 
when an I command is given, the cylinder address will be 
incremented by one, the head and sector addresses will 
not change. Cylinder address wrap-around occurs at 
114->000. Incrementing by cylinder address is useful 
for scanning quickly thru a large file by steps of 12 
sectors (four DOS.C clusters) per increment. 

If the S (Sector address mode) command is m force when 
an I command is given, the logical (or physical if m 
EBCDIC mode) sector address will be incremented by one. 
If the sector was the last on the track (014), then the 
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cylinder address is incremented by one and the sector 
address is set to zero. If the cylinder- address was 114 
(last on the pack), it will oe set to zero. 
Incrementing by sector enables scanning sector by sector 
thru a file and inspection of the exact data on each 
disk record. However/ sector by sector scanning will 
see a system sector (logical sector 014) between the 
last sector of a file on one track and before the first 
sector of that file on the next track. Files which span 
logical cylinders or are non-contiguous on the disk 
(which includes most large files) will require more 
uetailed understanding by the user of the DOS file 
structure (m order to avoid incrementing out of the 
file's allocated space) and are usually better examined 
using the DOS DUMP command as described m the DOS 
USER'S GUIDE. 

Decrement the cylinder or sector address and display the 
sector at the new address. Except for the direction of 
adaress change ^ the D command is functionally like the I 
command. Cylinder address wrap-around occurs at 
000->114/ and sector adaress wrap-around occurs at 
000->014o 

Cylinder address mode^ This command causes subsequent I 
or D commands to alter the cylinder address . 
Optionally, a cylinder address may be keyed m before 
striking the C key; the current cylinder address will 
De replaced by the entered value before the disk record 
IS read and displayed. The entered digits will be 
displayed at the lower left corner of the screen. Note 
that the address must be an octal address. If more than 
three digits are entered DUMP9380 will BEEP and the 
procedure must be re-begun- If the address entered is 
not a valid cylinder address (i.e., greater than 0114) 
the C command will be in force but the cylinder address 
will not be changed. Also note that only the eight 
least significant bits of the value entered will be 
taken for the address (a entered value 444 would be 
interpreted as 044). 

Sector address mode. This command causes succeeding I 
or D commands to alter the sector address . Optionally, 
a sector adaress may be keyed m before striking the S 
key. The address option is functionally similar to the 
C command. Sector aaaress inoae is the assumed moae of 
operation when the program is started. 
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ASCII display mode. This command causes the JDVtes to be 
displayed m ASCII instead of OCTAL on the screen, for 
all JDytes that have valid ASCII bit configurations, 
ihis IS useful for examining text files on disk. Note 
that the ASCII mode will carry over to the P (print) 
command of the PRIMARY COMMAND HANDLER unless changed dv 
a subsequent command. 

EBCDIC display mode. This command causes the bytes to 
be displayed m EBCDIC instead of OCTAL on the screen, 
tor all bytes that have valid EBCDIC bit configurations, 
ihis IS useful for examining the index track (track 
zero) on a diskette and for text files on IBM formatted 
diskettes. 

OCTAL display mode. This command causes the bytes to be 
displayed m OCTAL instead of ASCII. OCTAL mode is the 
assumed mode of operation when the program is started. 

As m the P (Print) command, there is a special case of the 
screen dump that provides for easy examination of a basic DOS 
fh^o^K n?n^' ^^? DIRECTORY. The directory is on tracks 021 
through 040, on logical sector 014 (the directory master) and 
tracks 1 through 020 (the directory copy). The special command 
s DX will display one directory sector at a time on the screen. 

i^L^?''v°''.? ^^^ directory as displayed by the S D command might 
look like this example: 



O 



021 


001 


103 


000 


000 


SYSTEMO 


SYS 


377 


000 


02 


040 


000 


00 


KIT.T, 


CMD 


377 




002 


100 


000 


000 


CHANGE 


CMD 


37 7 


000 


02 


140 


000 


000 


MANUAL 


CMD 


3 77 




002 


200 


000 


000 


SIN 


CMD 


377 




02 


2 40 


000 


000 


LGO 


CMD 


377 




002 


300 


000 


000 


SAPP 


CMD 


37 7 




034 


300 


00 


000 


EDIT 


CMD 


377 



002 340 000 

003 000 000 
003 040 000 
003 100 000 
003 140 000 
003 200 000 
003 240 000 
134 040 364 



000 CAT 
000 NAME 
000 AUTO 
000 OUT 
(^(^(^ SOnT" 

w *,» %ir KaJ^M" \^ J. 

000 APP 

000 ASM 

001 MASTER 



CMD 37 7 

CMD 37 7 

CMD 37 7 

CMD 377 

CMD 37 7 

CMD 002 

TXT 001 



Note from the diagram that the actual cylinder and sector 
address is displayed at the upper left corner of the screen, and 
that the display format for each directory entry is the same as 
the format of airectory entries printed by the special P c (Print 
the catalog) command. The octal number below the sector address 
IS the relative airectory page address; ooo->oi7 for the sixteen 
directory pages (sectors). 

COMMAND EXAMPLES: 
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S D 

IS the basic format for the screen directory dump. This command 
can JDe given only to the PRIMARY COMMAND HANDLER; there is no 
provision for going from the SCREEN DUMP COMMAND HANDLER directly 
to the screen directory dump format. The command above would 
cause the first sector of the directory master to be displayed. 

S D146 

Optionally, an octal number may be given immediately following 
the D. It must be less than or equal to 3 77 and is taken to be 
the PHYSICAL FILE NUMBER of a file which will be on the directory 
page that will be displayed. This provides a quick means of 
looking at the directory entry for a file if its PFN is known. 
Note that the DOS CAT command follows each filename/extension by 
the file's P.FN m parentheses. Note further that once a file's 
directory entry is accessed/ one need only look at the first two 
bytes of the entry to see where the file physically begins on the 
disk. By setting the last digit of the second byte (byte 1 of 
the entry) to zero, the resultant two-byte physical aisk address 
IS the DOS.C physical disk address of the RIB of the file. The 
most significant three bits of the second byte (which is the 
least significant byte) are the DOS.C cluster number, and the low 
order five bits (always zero for the primary RIB) are the sector 
numoer on that track. Note that since DOS.C only keeps four 
clusters per track, these clusters can be conceptually numbered 
0, 2,4 and 6; the actual two-bit cluster number is kept m the 
top two bits of the three bits allotted for the cluster number. 

3.6 SCREEN DIRECTORY DUMP Commanas 

As m the regular SCREEN DUMP COMMAND HANDLER, commands may 
be given to DUMP93bO while it is m the screen directory dump 
mode. The commands are not displayed as they are entered, since 
they are executed immediately. There are only four commands that 
can be given while m the screen directory dump mode: 

* Leave the screen dump mode. The program returns to the 
PRIMARY COMMAND HANDLER. 

I Increment the directory page address by one. To keep the 
aisk address pointers withm the directory, the sector 
aadress is never changed from 014 ana the cylinder auaress 
wraps arouna at 040->021. 

D Decrement the directory page aadress by one. VJrap-around 
occurs at 021->040. 
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F Flip to the alternate copy of the directory. The contents of 
each directory master page should be exactly matched by the 
contents of its corresponding directory copy page. The F 
commana is provided so this can be visually checked. Even 
single byte differences may be readily detected by easily 
flipping back and forth between the master and the copy page. 

3.7 Cassette operations 

CD - Cassette Dump 
CL - Cassette Load 

DUMP9380 can write to the front cassette aeck the contents 
of specified disk sectors, and can read DUMP93bO tapes from the 
front deck to load specified sectors. 

COMMAND examples: 

CD 000,000 002,014 

would mean: dump the sectors from cylinder 000, sector 000, thru 
cylinder 002, sector 014 to the cassette m the front deck. In 
other words, dump the first three cylinders of the disk to 
cassette. The CD command will dump from one sector to ten 
cylinders, m contiguous sectors. The disk addresses given 
(explicitly or implicitly) must be from lesser to greater (e.g. 
CD 40,0 36,12 would be invalid because the second aadress is less 
than the first address). If any fault is found m the addresses 
given, the message: 

PARAMETER ERROR 

will be displayed and the machine will BEEP. If the command is 
correct, the message: 

FRONT DECK SCRATCH ? 

will be displayed. A reply of "'Y" will cause the cassette dump 
to proceed, while a reply of "X" will cause an exit to the 
PRIMARY COMMAND HANDLER. When the front deck is ready, the 
cassette dump will rewind the tape and begin dumping the 
specified sectors to tape as individual 256-byte records. When 
all of the sectors have been written, the tape is rewound and 
checked sector by sector against the sectors on disk. If the 
tape aata does not match the disk data exactly, the cassette dump 
will abort with the message: 

TAPE/DISK VERIFY FAILURE 



3-10 



ana exit to the PRIMARY COMMAND HANDLER. If the tape is correct, 
It IS rewound and control is returned to the PRIMARY COMMAND 
HANDLER. 

CD 1 

IS interpreted to mean CD 000,000 001,014. 

Refer to the discussion of the P (print) command for more 
examples of explicit and implicit addresses m commands. 

CL 1 

means: load the disk sectors adaressed 000,000. thru 001,014 from 
the front cassette. Not more than ten cylinders may oe specified 
to be loaded from a cassette. The cassette load read routines 
expect to fina records of exactly 256 bytes on the tape for at 
least as many records as there are sectors to be loaded. If a 
record that does not meet the specifications is encountered 
before the last sector has been loaded, the cassette load will 
abort with the message 

BAD DUMP TAPE 

ana return control to the PRIMARY COMMAND HANDLER. It is not 
necessary that the records on the tape be written to the same 
disk addresses as from which they were read. Therefore, the CD 
and CL commands proviae a means of moving sectors from place to 
place on one aisk, or from one disk to another. It is not 
necessary that a CL read all of the records that may be on a 
cassette, only that there are at least as many records on the 
cassette as there are sectors to be loaded. When the specified 
sectors have been loaded, the tape is rewound and the tape 
records are re-read and matched against the loaded sectors on the 
disk. If the data on the tape does not match the data on the 
disk, the cassette load routine will abort with the message: 

TAPE/DISK VERIFY FAILURE 

ana exit to the PRIMARY COMMAND HANDLER. If everything is 
correct, the cassette loaa routine rewinds the front tape and 
returns control to the PRIMARY COMMAND HANDLER. 
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3.b Physical and logical drive numbers 

When DUMP9380 begins execution it assumes that it is to deal 
with the pack m drive zero. The @ command instructs DUMP93&0 to 
deal with the pack m the specified physical drive. 

COMMAND example: 
@ 1 

would mean: succeeding commands will refer to the pack m 
physical drive 1. The @ 1 command will remain m force until 
another @ command addresses a different physical drive. Note 
that the address parameter for the @ command consists of one and 
only one digit. 

DUMPy380 IS (as its name implies) a very low-level, physical 
device oriented dump command. DUMP9380 always works by physical 
drives. 

3.9 Error messages 

Some of the error messages produced by DUMP9380 and their 
meanings are explained below. 

PARAMETER ERROR 

This occurs if an invalid command and/or aisk address is 
given to the PRIMARY COMMAND HANDLER. Note that all disk 
addresses must be expressed m octal. 

SO MUCH ? 

This occurs if a command is given to dump more than 10 
cylinders to the printer. Note that one cylinder will fill 
several printer pages, and ten cylinders would represent a 
good-sized file. Respond "N" if you really don't want the 
printer to print out that many pages of paper. Otherwise, "Y" 
will cause the printing to proceed. 

CASSETTE TOO SMALL 

This occurs if a command is given to dump too many cylinders 
(more than 10) to cassette. 

TAPE/DISK VERIFY FAILURE 






This occurs during the tape-agamst-disk check phase of a 
cassette dump or cassette load if the data on the tape does not 
match exactly the data on disk. The tape is rewound and the dump 
or load should be retried. 

BAD DUMP TAPE 

This occurs if a tape record is read that does not conform 
to the DUMP9380 tape record format. If it occurs during a 
cassette load, no data from the bad tape record is written to 
disk. 

DISK NOT ON LINE 

This message is self-explanatory. 

DISK PROTECTED 

This occurs if the disk is protected and a cassette load 
command is given. Nothing will be written to the disk as long as 
the READ ONLY indicator is on. 

CR.C ERROR 

This occurs if a hardware read or write error persists after 
three attempts to accomplish the read/write unless the read error 
occurs during a printer dump command (so that data on bad sectors 
can be hard-copy recorded and examined). If a CR.C error 
occurs during a printer dump, the machine will beep. 

BEEP (Audio signal) 

See CR.C ERROR 

SECTOR NOT FOUND 

This occurs if the disk controller SECTOR NOT FOUND status 
bit IS set. This usually occurs as a result of the formatting 
information on a disk being incomplete or incorrect, but could 
also indicate a software or hardware malfunction. 
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CHAPTER 4- THE REPAIR COMMAND 



The purpose of REPAIR is to repair a malfunctioning or 
non-functioning DOS pack. The performance of the DOS is directly 
related to the correctness of disk-resident system tables. 
Errors m these tables can cause DOS difficulties ranging from 
occasional mysterious losses of data to complete inability of the 
DOS to function on the pack. REPAIR finds, identifies to the 
operator, and attempts to correct errors in the system tables. 

REPAIR, once activated by an operator, is capable of seeking 
errors and determining corrective measures on its own. However, 
there are operator interfaces which exist to give a human 
operator the power to monitor and control the program's progress. 
The program constantly displays on the screen information about 
what It IS doing. There are several points m the program's 
execution which ^Iwayis occur which require operator response. 
Finally, if errors are discovered the operator will oe asked if 
the error should be corrected on disk. Thus, the operator has 
control. Q2ij^ ^ny Changes made ta disk ^nd my: suppress any 

COrrectAOn suggested ^ ihg program . 

REPAIR consists of three phases; the Cluster Allocation 
i-jMe Mid Pirectory check phase, the Retrieval Information Blocks 
£h^Qk phase, and the Cluster Allocation Table regeneration phase- 
In general terms, the program progresses from simple error 
analysis to quite involved error analysis during its execution. 
Beginning with the cylmders-to-be-locked-out information 
supplied by the Lockout CAT on disk and supplemented the 
operator, each program phase progresses according to information 
developed or verified during preceding checks. 

The amount of interface and systems expertise required of 
the operator ranges from almost zero to very much, and is 
directly proportional to two things: how badly the pack is 
damaged and whether the operator wants to try to save files with 
errors. If the operator merely permits REPAIR to delete every 
file found to be m error, the result would be guaranteed to be 
error-free disk-resident system tables, and the operator would 
not need to understand any details of the DOS. Sometimes, 
however, it will be easier for the operator to take notes ana 
refer to the appropriate DOS aocumentation m order to save a 
file, rather than delete the file and then have to re-create it. 

REPAIR is a completely self-contained program and uoes not 



4-1 



require a working DOS to run. REPAIR can be executed as a 
COMMAND from the DOS or from an LGO cassette. REPAIR carries its 
own copies of the standard basic DOS I/O routines (DR$, DW$, 
KEYIN$, DSPLY$), the DOS interrupt handler ana the DOS DEBUG$ 
routine. 

4.1 Applications of REPAIR 

There are three general classes of errors that can cause a 
DOS to work improperly: 

l-fiuzatfi in ths. data Mitlyji §l tils.- Example: An 
incorrectly written object code record in a program object file 
will make the program unloadable and thus unexecutable. 

2. £LC£iiJLS JJl thQ QQ^ system lilas. Example: If one of the 
DOS system files were inadvertently damaged, as by being 
partially overwritten, then sooner or later some part of the DOS 
woula not function properly. 

3. ^joLQJLS. XR ths. iaULSJi sy stem tdaJai^s. Example: The cluster 
Allocation Table is overwritten. 

Far and away the most commonly occuring class of error is 
class 3. (Inciaentally, the most common error is the one given 
for the example: a destroyed CA.T.). Also, class 1 and class 2 
errors most often occur because of previously existing class 3 
errors. 

REPAIR will not find or fix class 1 or 2 errors. Once those 
errors have occurred the file with the error should be reloaded 
to disk. If the user is interested m fixing these kinds of 
errors he should refer to later sections in this chapter and 

REPAIR can fix almost all class 3 errors, and thus can fix 
almost all of the problems that commonly occur with a disk pack. 

4.2 When to use REPAIR 

There are three times to run the REPAIR program: 

1- Regular disk-pack checking , it never hurts to run REPAIR 
after every few hours of disk use, m order to catch errors that 
may be developing that haven't been noticed. 

2' Unexplained strange thi n g s st ar t happening , if you ever 
see the message: 
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FAILURE IN SYSTEM DATA 

It IS time to run REPAIR. If other error messages are displayed 
by the DOS, such as: 

RECORD FORMAT ERROR 

ana there seems to be no reason that the error should have 
occured, REPAIR may find the reason. If files or records m 
tiles disappear or get scrambled, it is probably a good idea to 
run REPAIR to see if errors have developed in the system tables. 

3. IM DO? will jiat run ai ^11- Many times if the DOS will 
not "boot" it IS because 1) The CAT has been destroyed - 
specifically, the auto-execute PFN (the last byte m the sector) 
IS not 000 (REPAIR will always reset the auto-execute PFN to 000 
when It writes the regenerated CAT to disk); or 2) The directory 
(one or more sectors) has been destroyed; or 3) One or more of 
the RIBs for the system files have been destroyed. 

4.3 Understanding REPAIR 

This chapter is divided into three major sections for three 
levels of reference: 

1. Minimal operator interface (Section 7.4). 

The first major section is for users who wish to use REPAIR 
to make their pack work again as quickly and with as little 
effort as possible. To use REPAIR, one does not have to 
understand very much about the DOS or the structure of the data 
on disk. 

2. Medial operator interface (Section 7.5). 

The second major section is a rather comprehensive 
discussion of the various messages and options provided by the 
REPAIR program, and is for users who wish to be able to take 
advantage of the file-saving options available with REPAIR. 

3. Maximal operator interface (Section 7.6). 

The third major section discusses a varitey of things that 
can go wrong on a aisk pack ana how REPAIR can be used to aeal 
with those problems. This section is for users who are 
interested m understanding the DOS system aisk aata structure 
for Its own sake, with emphasis, of course, on problems that can 
occur. 
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4.3.1 Preliminary reading 

At ajosolute minimum, anyone who wants to use the REPAIR 
program must understand some basic DOS concepts. The REPAIR user 
must have a concept of what a DOS Z1L£ is, ana should be 
acquainted with the use of the OPERATOR COMMANDS (entered at the 
DOS system console) and FILE NAMES . The user must unaer stand the 
concept of FILE DELETION . The user must also know what DRIVE 
IMUMBER means. 

If possible, the REPAIR user shoula read and understand the 
QQR Advanced Programmers^ Guide (Part IV of the DOS USER'S 
GUIDE), particularly section 3.1, Disk Structure . To use and 
understand REPAIR to the maximum extent, the user should 
understand terms such as: cylinder, sector, cluster allocation 
table, airectory, directory page, directory MASTER and COPY, 
directory entry, retrieval information block, segment aescriptor, 
and cluster. 

4.4 Minimal Operator Interface 

This section is for those who wish to use REPAIR to make 
their pack work again as quickly and with as little effort as 
possible. To use this section requires no knowledge of the DOS 
beyond the concept of files. It does require the ability to read 
through and understand the following step-by-step instructions. 

In the most ultimately simple case, the user will not want 
to lock out any cylinders (a cook-book process — you don't have 
to know what a cylinder is), and the REPAIR program will not find 
any errors. The main structure of the following example is built 

v/i* kiuv^ii u v^uoc. iK^wr w V cjL , pxa^^ea xii uiits CAaiiipxt:: wxiexc ciitJjLt: may 

be variations are noted and where m the manual to find 
explanations of the variations is also noted. 

4.4.1 Executing REPAIR 

If REPAIR IS catalogued on the disk (as REPAIR/CMD), and if 
the DOS is capable of loading ana executing it, the fastest and 
easiest way to get REPAIR started is by simply keying the command 
at the system console: 

REPAIR 

REPAIR may also be executed by placing a LOAD-AND-GO (LGO) 
tape of REPAIR m the back cassette deck and pressing RESTART. 
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In either case, the pack to be checkea must be placed m a 
drive connected to the computer and brought on line. 

^^^ ^^ ^^^ following examples, a pictogram of the state of the 
CRT display will be given followed by a brief explanation and 
instructions for the operator. 

Note that a pound sign (#) in one of the bottom two lines of the 
pictogram represents the cursor position. The cursor will be 
flashing when the operator is required to respond to the 
information on the screen. 

4.4.2 Sign-on and drive number specification 



DATAPOINT DOS.X REPAIR 



\. 



DRIVE NUMBER: # 



The screen appears as above when REPAIR has been loaded and 
execution has begun. 

The operator must enter the logical number of the drive 
holding the disk pack that is to be REPAIRed. 
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4.4.3 Cylinaer Lockout 



DATAPOINT DOS.X REPAIR 



DRIVE number: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? 

\ 



The screen may appear as above when REPAIR is ready to 
accept cylinaer lockout. Cylinder lockout is a way of reserving 
disk space from DOS use. If cylinders are to be locked out/ 
there will generally be a sticker or label on the case of the 
disk pack with the numbers of the cylinders to be reserved. If 
there are cylinders to be lockea out refer to Section 4.7. 

If no cylinders are to be locked out, enter "N". 

4.4.4 Directory check monitor 



/ 



DATAPOINT DOS.X REPAIR 









DRIVE NUMBER 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING cat: FORMAT LOOKS OK. 



\. 



The screen appears as above when the cylinder lockout option 
has not been taken and the £AX ^llfiL Directory check phase has 
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begun. Specifically, note the vertical numbers at the right 
center of the screen: these numbers monitor the cycling of the 
directory check. If something besides these numbers appears on 
the screen after the cylinder lockout is completed, refer to 
Section 4.b. 

l\lo operator response is required. 
4.4.5 Directory Errors 



/ 



DIRECTORY ENTRY COPY: DELETE INCOMPLETE 



MASTER 



COPY 



3 

2 6 



CAT 



C M D 



3 


3 3 3 3 


7 


7 7 7 7 


7 


7 7 7 7 C AT 



3 








7 





2 


M D 7 


6 






enter: 1=MASTER->C0PY, 2=DELETE BOTH, 3=N0 CHANGE: # 



\ 



The screen will appear as above (m general — specific 
words will vary) if REPAIR finds an error m the directory. 

For explanation of the messages refer to section 4.5.5. 
To delete the erroneous file enter the number corresponding to 
DELETE BOTH ( m this example, 2=DELETE BOTH). 

4.4.6 Retrieval Information Blocks check 



_/ 



RIB MASTER: 



(PFN 000) 



RIB COPY; 
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\ 

The screen appears as above during the Retrieval Information 
Blocks check. The vertical numbers at the right of the screen 
monitor the cycling of the RIB check. The column of asterisks is 
displayed only while a RIB is actually being checked. If a pack 
does not have many files on it the asterisks will not appear 
during most of the RIB check. 

No operator response is required. 
4.4.7 Retrieval Information Blocks errors 



/ 



PFN ERROR LRN ERROR 

4TH BYTE NOT 03 77 

1ST SEG.DES. ERROR 

MULTIPLE ALLOCATION 00001 

C YL . ADR . OVERFLOW CYL . ERROR 

RIB TERMINATOR ERROR 

3 2 
12 



* PFN ERROR LRN ERROR 

* 4TH BYTE NOT 03 77 

* 1ST SEG.DES. ERROR 

* MULTIPLE ALLOCATION 000 01 

* CYL. ADR. OVERFLOW CYL. ERROR 

* RIB TERMINATOR ERROR 

3 
7 



10 03SYSTEM0 SYS7 



DELETE THE FILE ? # 



V 



./ 



The screen will appear as above (in general - specific words 
will vary) if REPAIR finds an error m a RIB. 

For explanation of the messages refer to section 4.4.7. 
To delete the erroneous file enter "Y". 
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4.4.B Ena of RIB check 



/ \ 

0000 FILES HAVE RIB FORMAT ERRORS. 

0025 FILES HAVE NO RIB FORMAT ERRORS. 



CLUSTER ALLOCATION PHASE/ PASS 1. PFN # 



V 



The screen appears as above when the RIB check phase is 
finished. The messages at the top of the screen are a summary of 
the information accumulated during the RIB check phase. The 
message near the bottom of the screen is notification to the 
operator that REPAIR is ready to begin the cluster allocation 
phase. 

To proceed, depress the <ENTER> key. If no RIB format errors 
remain on the disk, pressing <ENTER> is not required. 

4.4.9 Cluster allocation phase, Pass 1 



/ \ 

0000 FILES HAVE RIB FORMAT ERRORS. 
002 5 FILES HAVE NO RIB FORMAT ERRORS. 







CLUSTER ALLOCATION PHASE, PASS 1. PFN 00 



4~y 



The screen appears as above during the first pass of the 
cluster allocation phase. The vertical numbers at the right of 
the screen are the pass cycle monitor. 

No operator response is required. 

4.4.10 Cluster allocation phase, Pass 2 



/ 



0000 FILES HAVE RIB FORMAT ERRORS. 
0025 FILES HAVE NO RIB FORMAT ERRORS. 



\ 



CLUSTER ALLOCATION i:>HASE, PASS 1. PFN 000 
CLUSTER ALLOCATION PHASE, PASS 2. PFN 00 









V 



The screen appears as above during the cluster allocation 

phase, pass 2. The bottom message is displayed and the cycle 

monitor numbers at the right of the screen are restarted when 
pass 2 begins. 

No operator response is required. 
4.4.11 Cluster allocation phase, pass 3 



./ 



/ 



0000 FILES WITH ALLOCATION CONFLICTS. 
00000 CLUSTERS IN THOSE FILES. 



CLUSTER ALLOCATION PHASE, PASS 1. PFN 000 
CLUSTER ALLOCATION PHASE, PASS 2. PFN 00 
CLUSTER ALLOCATION PHASE, PASS 3. # 
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The screen appears as above at the ena of the cluster 
allocation phase, pass 2. The messages at the top of the screen 
are a summary of the information gathered auring cluster 
allocation phase pass 1 and 2. The message at the Dottom of the 
screen indicates that REPAIR is ready to jDegm the cluster 
allocation phase pass 3. 

To proceed, depress the <ENTER> key. If no allocation 
conflicts are present, it is not necessary to press <EInITER>. 

4.4.12 Cluster allocation conflicts 



PFInI 2UU 

3 

b 

3041SIN CM 

ft OF CLUSTERS IN FILE: 00001 
# OF C01MFLICTIi\IG FILES: 02 
ft OF CONFLICT IWG CLUSTERS: 00001 





PFlNl 22 




3 


3 


3 


7 


6 


7 


7 


3641SOUT 


C M D 7 




ft OF CLUSTERS IN 


file: 00002 




CONFLICTING FILE 


# 001 


01 


ft OF CONFLICTING 


clusters: 00001 



ft OF CORRECT PFN/LRN: 00004 OF 00006 # OF CORRECT PFN/LRN : 00000 OF 00006 
enter: delete FILE: 1=LEFT , 2=RIGHT, 3=B0TH; 4=N0 CHANGE: # 



V 



The screen will appear as above ( m general, specific words 

will vary) it REPAIR finds that two or more files are trying to 
use the same space on disk. 

For explanation of the messages refer to 7.5.12. 

To aelete the files in error enter •'3"'. 
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4.4.13 Cluster Allocation Table replacement 



OOOOQ CLUSTERS IN THOSE FILES. 



V 



CLUSTER ALLOCATION PHASE, PASS 1. PFN 00 

CLUSTER ALLOCATION PHASE, PASS 2. PFN 00 

CLUSTER ALLOCATION PHASE, PASS 3. 

WRITE NEW CA.T. TO DISK ? # 









__/ 



The message on the last line of the screen above will appear 
when REPAIR has completed all of its checks and is ready to write 
the regenerated CAT to disk. 

To overwrite the CAT on disk enter Y. To prevent overwrite 
of the CAT on disk enter N. If no errors have been discovered by 
REPAIR, the operator should enter N. 

Then a message will appear asking if the Lockout CAT is to 
be written back to the disk as well. 

To overwrite the Lockout CAT on disk (making any additional 
cylinders locked out during the primary stages of REPAIR 
permanent) enter Y. To prevent overwrite of the Lockout CAT on 
disk enter N. If no errors m the Lockout CAT have been 
discovered by REPAIR and no additional cylinders were locked out, 
the operator should enter N. 
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4.4.14 Termination of REPAIR 






CLUSTER ALLOCATION PHASE, PASS 1. PFN 00 

CLUSTER ALLOCATION PHASE, PASS 2. PFN 00 

CLUSTER ALLOCATION PHASE, PASS 3. 

V^RITE NEW CA.T. TO DISK ? N 
WRITE NEW LOCKOUT CAT TO DISK ? N 
DISK REPAIR DONE. 



\. 



The message on the last two lines of the screen above will 
appear when the REPAIR program is finished checking the disk. 
The REPAIR program aoes not attempt to re-load the DOS when it is 
finished. To get any other program running on the computer again 
the operator must press the RESTART key. 

Wo operator response is requirea. 

4.5 Medial Operator Interface 

This section is a rather comprehensive discussion of the 
various messages and options provided by REPAIR, and is for users 
who wish to be able to take advantage of the file-saving options 
available with REPAIR. To use this section will require that the 
user gam an understanding of whatever error (s) REPAIR finds that 
the user wishes to repair. For example, if the only errors on 
the user's pack are in the directory, it is not necessary that 
the user study to understana about Retrieval Information Blocks 
or Cluster Allocation. 

This section follows the section numbering scheme of the 
previous section. Minimal Operator Interface. 

When a facet of REPAIR operation is discussed more 
appropriately elsewhere, the aiscussion is not repeated m this 
section, DUt the user is referred to the section containing the 
discussion. 
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Discussions in this section will occasionally refer to 
pictograms of the state of the display m other sections. 

4.5.1 Executing REPAIR 

If REPAIR IS cataloged on the disk (as REPAIR/CMD), and if 
the DOS IS capable of loading and executing it, the fastest and 
easiest way to get REPAIR started is by simply keying the command 
at the system console: 

REPAIR 

REPAIR may also be executed by placing a LOAD-AND-GO (LGO) 
tape of REPAIR in the rear cassette deck and pressing RESTART. 

In either case, the pack to be checked must be placed m a 
drive connected to the computer and brought on line. 

Note that a pound sign {#) in one of the bottom two lines of 
the pictogram represents the cursor position. The cursor will be 
flashing when the operator is required to respond to the 
information on the screen. 

4.5.2 Sign-on and drive number specification 
Refer to the pictogram in 4.4.2. 

After the operator has entered the number of the drive 
holding the pack to be REPAIRed, REPAIR will wait for that drive 
to come ready before preceding to do cylinder lockout. 

4.5.3 Cylinder lockout 

Section 4.7 is a discussion with examples of the cylinder 
lockout process. 

Cylinders are locked out because they give read/write errors 
or because by system design they are to be reserved for some 
special use. 

4.5.4 Directory check monitor 

Refer to the pictogram in 4.4.4. 

The Directory check monitor is the means by which REPAIR 
indicates its progress to the operator. Specifically, the 
directory check monitor constantly displays the disk address of 
the current directory entry being checked. This display is in 
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the form of two vertically displayed octal numbers at the right 
of the screen. The first number is a directory sector number 
indicator, and the second number is the buffer page address of 
the directory entry being checked. 

If the directory check monitor stops and no other messages 
are displayed, then the REPAIR program was loaded to memory 
improperly or something is wrong with the hardware. 

4.5.5 Directory errors 

The directory is a table of entries for files on the pack. 
Their are two copies of the directory, the MASTER and the COPY. 
There are 16 pages to each copy of the directory, each page holds 
entries for up to 16 files. (One disk physical sector is one 
directory logical page). Thus, the directory has a MASTER and a 
COPY entry for up to 256 files. 

The REPAIR program checks the directory one file at a time. 
That is, the MASTER and the COPY of a directory entry are checked 
at the same time- 

If an error in the MASTER or the COPY entry or both is 
detected, REPAIR will display: 

1. h brief error d escri p tion at the top of the screen, 

2. The MASTER and COPY entry across the lower center of the 
screen, 

3. An. option message near the bottom of the screen. 

The error description will indicate whether the error is in 
the MASTER or the COPY entry or both, and will define the type of 
error. 

Note that although directory entries for a file may have 
several types of errors at the same time, REPAIR will only deal 
with one error type at a time. 

The directory entries are displayed under their respective 
headings; MASTER: and COPY: . The first four bytes and the last 
byte of each entry are always displayed m vertical octal. The 
bth thru 15th bytes (being the file name and extension) of each 
entry are displayed m ASCII except for bytes m those fields 
which cannot JDe aisplayed m ASCII on the CRT display; those 
Dytes will be converted to vertical octal. 
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The option message at the bottom of the screen will enable 
the operator, by selecting and entering a digit, to correct the 
MASTER entry with information from the COPY entry, to correct the 
COPY entry with mforaiction from the MASTER entry, to delete both 
entries (and thus the file), or to make specific changes to one 
or both entries, or to make no change at all to either entry. 

Below are examples of the various directory errors that may 
occur and discussions of the respective messages. The first 
example is the most complete; the other directory error routines 
work basically the same way but their examples are not as 
expanded. 

Note that for the examples concerning the directory MASTER, 
the same messages (transposing the words COPY and MASTER) apply 
to the directory COPY. 

4.5.5.1 Delete errors 

Delete errors include those where the directory entry master 
IS deleted and the copy is not deleted, or the directory entry 
master is partially deleted* 

4.5.5.1.1 One entry deleted 



DIRECTORY ENTRY MASTER: DELETED 



MASTER: 

33333333 33333333 
7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 
7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 



COPY 



3 3 
6 
2 4 1 C A T 



3 

7 

C M D 7 



ENTER: 1=C0PY->MASTER , 2«DELETE BOTH, 3=N0 CHANGE: # 



\_ 



The screen will appear as above if REPAIR finds a file for 
which the directory MASTER entry is deleted (fillea with 0377 's) 
but the directory COPY is not. 

The operator has three options: 

1- Eiii;^r 111 iQ copy the copy entry to the MASTER entry. 



Q 
2 
6 



./ 
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thus saving the file's name m the directory; 

2. Knter ::2J: is aelete both entries, and thus the file; 

3. gnter 13^ is take no. action on the file's entries ana 
continue the directory check. 



/ 

DIRECTORY ENTRY MASTER: DELETED 



MASTER: COPY 

3333333333333333 0330 

"/ '/ 7 '/ 7 7 7 7 7 7 7 7 7 7 7 7 6 

7 '/ 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 4 1 C A T 

EIMTER: 1=C0PY->MASTER, 2=DELETE BOTH, 3=1nI0 CHANGE: 1 
*** ARE YOU SURE ? *** # 
\ 



3 





7 


2 


C M D 7 


6 



The message on the last line of the screen above will appear 
when the operator has selected ana entered one of the digits 
given m the option message. REPAIR will always make sure the 
operator entered what he intended to before proceeding to carry 
out the funciton. 

To carry out the function selected enter -'Y". If "N" is 
entered the option message will be re-displayed. 



MASTER: COPY: 

0330 30330 3 

0060 7 0060 7 00 

2041CAT CMD7 2041CAT CMD7 02 



ENTER: 1=C0PY->MASTER , 2=DELETE BOTH, 3=N0 CHANGE: 1 
**^ ARE YOU SURE ? ^^'' Y 
DONE. 
\ 



6 
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The screen will appear as above if the operator has replied 
"1" to the message above and replied "Y" to the message "*** ARE 
YOU SURE ? ***". When REPAIR does an entry to entry copy, both 
entries are re-di splayed to show the operator the results of the 
copy, and the message: "DONE." is displayed at the bottom of the 
screen. 

No further operator response is required. 



/ 



DIRECTORY ENTRY MASTER: DELETED 



V 



MASTER : 

3333333333333333 
7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 
7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 



copy: 

33 3 3333333333333 
77777777777 7 7 77 7 
777777 7 77 7 77777 7 



enter: 1=C0PY~>MASTER, 2«DELETE BOTH, 3=N0 CHANGE: 2 

*** ARE YOU SURE ? *** y 

DONE. 




2 
6 



The screen will appear as above if the operator has replied 
"2" to the message above and replied "Y" to the message "*** ARE 
YOU SURE ? ***". When REPAIR deletes the entries from the 
directory, the entries are re-displayed to show the operator that 
the delete has been accomplished, and the message: "DONE." is 
displayed at the bottom of the screen. 



No further operator response is re'^uirsd. 
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master: 

333333333333 3 333 

7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 

7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 



COPY 



3 3 
6 
2 4 1 C A T 



3 


U 


7 


2 


C M D 7 


6 



enter: 1=C0PY->MASTER, 2=DELETE BOTH, 3=W0 CHANGE: 3 
^^-^ ARE YOU SURE ? -^^^ y 



\, 



The screen will appear as aiDove if the operator has repliea 
■'3" to the message above and replied "Y" to the message •'*** ARE 
YOU SURE ? ^**". REPAIR Will make no change to the entries and 
will resume the directory check. 

No further operator response is required. 
4.5.5.1.2 Delete incomplete 



/ 



DIRECTORY ENTRY MASTER: DELETE INCOMPLETE 



MASTER 



COPY 



3 3 3 
7 7 7 



3 3 
7 7 



7 7 7 7 7 7 T 



3 

7 

C M D 7 



3 3 
6 
2 4 1 C A T 



J 





7 


2 


C M D 7 


6 



ENTER: 1=C0PY->MASTER , 2=DELETE BOTH, 3=N0 CHANGE: # 



V 



The screen will appear as above if REPAIR finds a file for 
which the directory MASTER entry is partially deleted (partially 
filled with 0377 's) but the directory COPY is not. 

The operator options ano REPAIR actions are the same as for 
Oae .^n tr y deleted , see 4.5.5.1.1 above. 
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4.5.5.2 RIB Address errors 

RIB Address errors include invalid RIB addresses or unequal. 
4.5.5.2.1 RIB Address Invalid 



/ 

DIRECTORY ENTRY MASTER: R.I.B. ADDRESS INVALID 



MASTER: COPY 



3 3 30330 300 

b 7 0060 7 02 

4 1 C A T CMD7 2041CAT CMD7 60 



ENTER: 1=C0PY->MASTER , 2=DELETE BOTH, 3=N0 CHANGE: # 
\ 



The screen will appear as above if REPAIR finds a directory 
lyiASTER entry with an invalid RIB address. 

In this example, the RIB address of the directory MASTER 
(the area m the box) is invalid because the cylinder address is 
000. 

The RIB address is the first byte and the top two digits of 
the second byte of a directory entry. The first byte is the 

CVlindPr ^irlrir-occ anH 4-<^ k,o, Tral-.« «,,,«4- k^ — j-_t ■_- ..i. - 

-^ — ~^_w.^ s-i*>- 4.^^ t^xi. »cijLa.»-i iiiuou iJC ail Ul-cax XlUinjJt;:i£ J.I1 TLIlfci 

range 001 thru 0114 inclusive. The top two digits of the second 
byte define the cluster number and to be valid must be one of the 
following: 

00, 10, 20, 30 

The operator has three options: 

1. Enter "l" iQ co py the copy entry rib address to the 
MASTER entry RIB address; 

2. Snter "2" to. delete both entries, and thus the file; 

3. Enter ^1:1 JLq taXe no. action on the file's entries and 



_/ 



■20 



resume the directory check. 

DIRECTORY ENTRY MASTER: R.I.B. ADDRESS INVALID 

master: COPY: 

3 3 30330 300 

0060 7 0060 V 2 

03 4 1CAT CMD7 2341CAT CMD7 60 

enter: 1=C0PY->MASTER/ 2=DELETE BOTH, 3=N0 CHANGE: 1 
**^ ARE YOU SURE ? *** # 
\ 



The message on the last line of the screen above will appear 
if the operator has replied "1" to the message above. 

To carry out the function selected enter -'Y". 

/ ~~ 

DIRECTORY ENTRY MASTER: R.I.B. ADDRESS INVALID 



MASTER: COPY: 

0330 303 3 300 

OObO 70060 7 02 

3 4 1 C A T C M D 7 2 3 4 1 C A T C M D 7 6 

ENTER: 1=C0PY->MASTER , 2=DELETE BOTH, 3=N0 CHANGE: 1 
MOVE ENTIRE ENTRY ? # 
\ 



The message on the last line of the screen above will appear 
if the operator replied "Y" to the message •'*^* ARE YOU SURE ? 

*. A A >' 

Enter -'N" to have REPAIR copy the R.I.B. address (only) from 
the COPY entry to the MASTER entry. Enter "Y" to have REPAIR 
copy the entire COPY entry to the MASTER entry. 

The "MOVE ENTIRE ENTRY ? - option is given to give the 
operator the ability to correct many types of errors m an 
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errornous entry at one time, rather than correct each error as it 
IS found. If the operator can recognize a severly destroyed 
entry the first time he sees it, this option can enable him to 
repair the directory more quickly. 

4.5.5.2.2 RIB Addresses not equal 

/ ~ ~~~ 



DIRECTORY ENTRY MASTER & COPY: R.LB. ADDRESSES NOT EQUAL 



MASTER : COPY: 

O^^O 30330 300 

0^0 70060 702 

2341CAT CMD7 3341CAT CMD7 



6 



ENTER: 1=MASTER->C0PY, 2=C0PY->MASTER , 3=DELETE BOTH, 4=N0 CHANGE: # 

\ 



The screen will appear as above if REPAIR finds a file with 
directory entries with RIB address that are both valid but not 
equal. 

In this example, the RIB address in the MASTER is 002,300 
and m the COPY is 003,300. 

The operator has four options: 

1- £Jli^£ :1JL: to, gopy the MASTER entry RIB address to the 

POPV Cir\^y\T DTD ->,*r*,^^^^. 

2- £lit£r 11:L tSi £<2£y the copy entry RIB address to the 
master entry RIB address; 

3- Enter 2A1. tJSi delete both entries, and thus the file; 

4. Enter IjH iLQ take Hi^ jasiAiSJl on the file's entries and 
resume the directory check. 

If It IS not obvious by visual inspection of the directory 
entries which is m error, the operator should note the RIB 
adaress as givdn by each directory entry, and enter '4". If 
REPAIR later discovers PFN and LRN errors m the actual RIBs for 
the file (see 4.5.7), then the operator can be fairly sure the 
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directory MASTER entry for the file is m error, since only the 
directory MASTER entry is used to determine the RIB address of a 
file for the RIB check phase of REPAIR. 

If the operator wants to make very sure which, if either, of 
the directory entries is correct, he can use the DUMP or DUMP9370 
commands to look at the file after REPAIR has finished execution. 

When it is determined which directory entry for the file has 
the correct RIB address, the operator can execute REPAIR again, 
this time entering "1" or "2-* as appropriate to correct the 
erroneous directory entry. 

If neither entry is correct, and it would be easier to 
modify the directory entries for the file than to delete them and 
re-create the file, refer to the available DOS documentation 
(both m the DOS SYSTEM GUIDE and the DOS USER'S GUIDE) for 
details on ways to modify the directory sectors on disk. 

4.5.5.3 File protection not same 



DIRECTORY ENTRY MASTER & COPY: FILE PROTECTION NOT SAME 



ENTRY MASTER: WRITE PROTECTION 
ENTRY copy: NO PROTECTION 
MASTER : 



COPY 



3 3 
6 
2 3 4 1 C A T 



3 

7 

C M D 7 



3 3 
6 
2 4 1 C A T 



3 

7 

C M D 7 




2 
6 



enter: 1=DELETE ENTRIES, 2=N0 CHANGE ;PROTECTION : 3=N0NE , 4=DELETE , 5=WRITE: # 



V 



./ 



The screen will appear as above if REPAIR finds a file with 
directory entries with protection not tlie same. 

In this example, the directory MASTER entry has WRITE 
protection indicated for the file, while the directory COPY entry 
has no protection indicated for the file. Note: where the bits 
for Doth WRITE and DELETE protection are set, WRITE protection 
has precedence, since WRITE protection implies DELETE protection. 

The protection indication is m the Dottom two Dits (bottom 
digit) of the second byte of a directory entry. If the upper bit 
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of the two IS set on (the digit is 2) then the directory entry 
ITTlly.^''^^ ^^^ '"^^ "" ^^^^^^ protected. If the bottom bit is 
fhJ^^J ^^'''■^'■^ IS 1 or 3) then the directory entry indicates 

sefon ?th^ ^"'.'^'^n.^^^^^"^^"- ^^ ^^^^^^^ °f the two bits is 
nrnf^^/ % '•^'•u ^^ °^ then the directory entry indicates NO 
protection for the file, that is, that the file is unprotected. 

The operator has five options: 

1- £lLtSX 111 to. iifiifets both entries, and thus the file; 

2- JEnifij: 111 iQ i^}^ XXQ action on the file's entries and 
resume the directory check; 

3- £lLt£X 111 tn .££i both entries to indicate NO protecti 
4. £jii^i ^:jrl j^ ^^ tioth entries to indicate DELETE 

^' SIilLsjl 111 to. set both entries to indicate WRITE 
protection. 

4.5.5.4 Name-Extension not equal 



on; 



DIRECTORY ENTRY MASTER & COPY: NAME-EXTENSION NOT EQUAL 



MASTER: COPY: 

^ ^ ^ ^ 3 3 3 3 

b 7 6 ^^ ° " 

2041CATXXXXXCMD7 204 1 CAT CMD7 60 

enter: 1=MASTER->C0PY, 2=C0PY->MASTER , 3=DELETE BOTH, 4=N0 CHANGE: # 



V 



The screen will appear as above if REPAIR finds a file with 
airectory entries that do not have the same NAME/EXTENSION. 

. .V. ^h^^NAME/EXTENSION of a directory entry is located m bytes 
5 through 15 inclusively. The NAME/EXTENSION of a directory 
entry (and the file) is the normal means by which the file is 
Identified and manipulated, especially from the DOS system 
console. ^ 
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Note that REPAIR does not seek or identify as erroneous 
files with NAME/EXTENSIONS that contain non-ASCII characters, 
since by DOS rules non-ASCII characters are perfectly legal in 
the NAME/EXTENSION field. 

The operator has four options: 

1- Enter 111 tQ copy the master entry name/extension to the 
COPY entry NAME/EXTENSION; 

2. Enter HI ifi copy the copy entry name/extension to the 
MASTER entry NAME/EXTENSION; 

3. Eaiar :!A1 ia delete both entries, and thus the file; 

4. Enter ^ll:: xo. taKe aa acti o n on the file's entries and 
resume the directory check. 

4.5.6 Retrieval Information Blocks check 



/ 



RIB MASTER: 



[PEN 00 0) 



RIB COPY: 









\ 



The screen appears as above during the Retrieval Information 
Blocks check. 

REPAIR checks Retrieval Information Blocks (RIBs) for all 
files m the directory with a valid RIB address, in the order of 
the files' occurrence m the directory. The three-digit octal 
number after "PFN" m the top line will indicate the actual 
Physical File Number currently being checked. The two 
vertically-aisplayea octal numbers at the right of the screen 
provide the same information as the directory check monitor 
described in 4.5.4. 
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RIB MA^TFR ^l\l ° ^"^ *°'' ^^'"'^ ^"^' 3 FASTER ana a COPY. The 
!^\^ cf^ ^ ''^ "^""^ *^^^^ "^^^"^"^ 1" the file and the RIB COPY 
2f6-nv^f 2 "^°" ^" ^^ *^^^- Each RIB uses one full 

description Of ^^f"""; ''^*" ^° ^^^ appropriate DOS manuals for a 
description of the structure of the RIfls. 

descrihinrfhf '^ftects any errors in the RIB MASTER a message 
the screen nn^.^^tf f ^"°^ "^^^ ^ displayed in the portion of 
^nv ^ll^Vl !u ^^^ heading "RIB MASTER:". If REPAIR detects 

pSrt!on ol tL =^ ""^^ ^°" ^ ""^""^S^ ""1 ^ displayed in the 
portion of the screen under the heading "RIB COPY:". 

The PFN indicator and the cycle monitor numOers are 
cllllTTLt'''' T^^^^^'' *°^ ^^^'^ ^"try in the dtrec^ory. The 
are "^tufl?f ^"''^ k^ displayed only while the RIBs for a file 
are actually being checked. 

4.5.7 Retrieval Information Blocks errors 



LRN ERROR 



RIB master: 
PFN ERROR 
4TH BYTE NOT 03 7 7 
1ST SEG.DES. ERROR 
MULTIPLE ALLOCATION 00001 
CYL. ADR. OVERFLOW CYL. ERROR 

RIB TERMINATOR ERROR 



(PFN 00 



RIB copy: 



PFN ERROR LRN ERROR 

4TH BYTE NOT 037 7 

1ST SEG.DES. ERROR 

MULTIPLE ALLOCATION 00 001 

CYL .ADR. OVERFLOW CYL . ERROR 

RIB TERMINATOR ERROR 



\ 



^u ^.^^ screen will appear as above if REPAIR finds errors m 

Qiven inThfLr f ^\'°" ^ ''^^' ^^^^ ^^^^ ^^l °f the messages 
given m the example above will not necessarily appear. The 

^heck'wa^ Tr '"^^^^ '^^ ^""^^" ^^ ^^ ^^^1^ appear While the RIB 
screen when thf^PTr^; u^? ^^^^ pictogram shows the state of the 
screen when the rib check has finished and has displayed the 
file s directory MASTER entry and is ready for operator response. 

abnv/^^?n tU fjiscussion of each of the messages m the screen 
therr*rP^Lrt?vf ^""^ f^''^^^'^^"' ^^^ possible messages are shown m 
COPY i1n?r^i^ positions for both the RIB MASTER and the RIB 

forLt.. Hn^^on ^'-'"''^ }^^ ^^^ ^''^^^^ ^^^ ^0^^ ^^ve the same 
tormats, (indeed, normally they are exact duplicates of each 
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other, except for their Logical Recora Number [LRW] ) they can 
have the same errors. 

There are two types of errors that a RIB may have: simple 
ana complex - If REPAIR fmas only one simple error m only one 
of the RIBs then the operator will be given the option of having 
REPAIR correct the error. If multiple simple errors or any 
complex errors are detected then the errors are too serious for 
REPAIR to cope with, and will only give the operator a choice 
between deleting the file or making no change at all. Even with 
multiple or complex errors the file may be saveable though, refer 
to 7.6.7. 



£FM ERROR 

This message is displayed if the first byte of the RIB is 
not the file's Physical File Number (PFN). This is a simple 
error and is correctable under the conditions given aDove. 

LRN ERROR 

This message is displayed for the RIB MASTER if the Logical 
Record Number (LRN) is not zero, and for the RIB COPY if the LRN 
IS not one. This is a simple error and is correctable under the 
conditions given abov-e. 

4TH BYTE NOT 03 7 7 

This message is displayed if the 4th byte of the RIB is not 
0377. When the DOS object code loader loads a program into 
memory it skips over disk records with a 03 7 7 m the 4th Dyte: 
since the RIBs of a file are not part of the object code of a 
file their fourth byte should always be 0377 so the loader will 
not attempt to load them to memory. This is a simple error and 
IS correctable under the conditions given above- 

i^ SEG.DES. ERROR 

Expanded: First Segment Descriptor Error» This message is 
displayed if the first segment descriptor of the RIB does not 
point to Itself. Since the RIBs are the first two records m any 
file, they will always be m the first cluster. The first 
segment descriptor must point to the Degmnmg of the file, which 
IS the cluster where the RIBs are. 

MULTIPLE ALLOCATI ON 00001 
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This message is displayed if REPAIR discovers that, 
according to the RIB's SEGMENT DESCRIPTORS, two or . more SEGMENTS 
of the file overlap. Specifically, SEGMENT DESCRIPTORS identify 
CLUSTERS on the disk which iDelong to the given file- If one or 
more of these CLUSTERS is indicated as belonging to more than one 
SEGMENT, then there is MULTIPLE ALLOCATION of CLUSTERS. The five 
digit octal number indicates how many CLUSTERS are multiply 
allocated. 

CYL.ADR.OVF.l^FTi^W 

This message is displayed if REPAIR discovers a SEGMENT 
DESCRIPTOR which indicates that a SEGMENT overruns the physical 
end of the aisk. Of course it is not actually possible for a 
file to extend beyona the upper limit of the disk space, but it 
is possible for a SEGMENT DESCRIPTOR to erroneously indicate 
this. For example, a SEGMENT DESCRIPTOR might say, m effect: 
"This SEGMENT begins at the last CLUSTER on the disk and extends 
for ten CLUSTERS". 

CYL. ERROR 

This message is displayed if REPAIR discovers a SEGMENT 
DESCRIPTOR with a cylinder address that is either (always 
reservea) or greater than decimal 76 (the last cylinder on a 
disk) . 

&I3. TERMIIMATOR ERROR 

This message is displayed if REPAIR discovers a RIB that has 
an incorrect terminator. The logical end of a RIB is indicated 
by either the actual physical end of the disk record or a pair of 
0377's._ An 0377 m the first Dyte of a SEGMENT DESCRIPTOR but a 
non~U37 7 in the second hvtp ripfinoc: ;^ TPDwiTMaTOD cddod 
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/ 

PFN ERROR 



2 3 3 

6 7 

2 4 1 C H A N G E C M d 7 

DELETE THE FILE '? # 

The screen will appear as above when REPAIR has completed 
the RIB check for a file whose RIBs haa only one simple error. 
l^ote that the screen is rollea up one line so that the heaumg 
containing the PEN is no longer aisplayea. However the directory 
MASTER entry for the file, containg the NAME/EXTENSION for the 
file, is displayed under the error message area. 

To simply have REPAIR delete the file enter "Y". To attempt 
to save the file enter "N". 



2 3 0. 3 

6 7 

2041CHANGE CMD7 



DELETE THE FILE ? N 
V^RITE CORRECTIOW TO DISK ? # 
\ 



The message on the last line of the screen above will appear 
if the operator replied "N"* to the luessage above. 

Enter "Y" to have REPAIR write the correct RIB information 
to the RIB m error and resume the RIB check. 
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3 3 
6 
2 4 1 C 



H A N G E 



3 

7 

C M D 7 



V 



DELETE THE FILE ? N 

WRITE CORRECTION TO DISK ? N 

FILE SPACE WILL NOT BE ALLOCATED.* 



./ 



The message on the last line of the screen above will appear 
If the operator replied "N" to the message above. REPAIR will 
not allocate space (by setting the appropriate bits m the CAT) 
for a file if there is any uncorrectable error m either of the 
RIBs. 

REPAIR will wait until the operator depresses the ENTER key 
before resuming the RIB check. 



/ 



3 3 
6 
2 4 1 C H A 



N a V. 



3 

7 
r M n 7 



\ 



RIBS' SEGMENT DESCRIPTORS NOT EQUAL 
DELETE THE FILE ? # 



The messages on the last two lines of the screen above will 

appear if the RIB MASTER and COPY for a file individually have no 

format errors but do not describe the same segments for the file. 

Enter "Y" to delete the file from the directory. Enter "N" 

to make no change to the file and resume the RIB check. 

NOTE that whether or not the file is deleted REPAIR will not 
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allocate any space on disk for the file (refer to the pictogram 
and discussion aJDove). The consequence of this is that, although 
the file will still J^e accessable, the space it occupies m 
marked as available for allocation to some other file. As a 
result/ the remains of the file on disk are almost certain to be 
overwritten by some other file sooner or later. 

4.5. b End of RIB check 

Refer to the pictoyram in 4.4.b. 

When all of the RIBs for all of the files on the disk have 
been checked REPAIR will count the number of files with 
uncorrected RIB format errors and the number of files with no RIB 
format errors and will display the counts on the screen. The 
tiles that do have RIB format errors will not be allocatea space 
on disk and will not be processed m the CLUSTER ALLOCATION PHASE 
( below) . 

4.b.9 Cluster .allocation phase, Pass 1 

Refer to the pictogram m 4.4.i^. 

The CLUSTER ALLOCATION PHASE of REPAIR re-constructs in 
memory the CAT from the information m the RIBs of files that 
have no RIB format errors. The CLUSTER ALLOCATIOiSl PHASE consists 
of three passes. The first pass makes one pass through all the 
files on the pack with no RIB format errors ana builds m memory 
two cats: one for all files that have no space (cluster 
allocation) conflicts with other files and a second tor files 
which do have cluster allocation conflicts. 

4.5.10 Cluster allocation phase, Pass 2 

Refer to the pictogram m 4.4.10. 

The second pass of the CLUSTER ALLOCATION PHASE makes 
another pass thru all the files allocated to the first CAT and 
finds any that may have conflicts with space allocated to the 
second CAT, and removes those files' space allocation from the 
first CAT and allocates their space to the secona CAT. 

4.5.11 Cluster allocation phase, Pass 3 

Refer to the pictogram m 4.4.11 

The third pass of the CLUSTER ALLOCATION PHASE aoes an 
analysis on any two files with aisk space (cluster aliocation) 
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conflicts with each other and displays the results of the 
analysis on the screen (see 4.5.12 below). If no fil^es have 
cluster allocation conflicts REPAIR displays the CLUSTER: 
ALLOeATIC^N TABLE REPLACEMENT message ( see .4. 5 ^13 below) . 

^'^'^2. (S^lustef Allocation ■ conflict^ 



PFN 20 
3 
6 
3 4 1 S 



\ 



IN C M a 7 

# OF CLUSTERS IN FILE:. OOOOi 

# OF CONFLICTING FILES: 002 

# OF CONFLI'CTING CLUSTERS: 00001 

# OF CORRECT PFN/LilN: 00004 OF 00006 



PFN 22 
a 3 

6 7 

3 4; 1 ;S a U T , C M D 7 

#, OF CLUSTERS; IN , file: 00002 

CONFLICTING FPLE # 01 

# OF C0N|:LICTINQ clusters: 00001 

# OF CORREgr PFN/LRJSJ: OQOOO of 00006 



enter: delete FILE: 1=LEFT , 2=RIGHT, 3=B0TH; 4=N0 CHANGE: # 



V 



The screen appears as above ( m general, specific words will 
vary) if REPAIR finds two. files wit Ji clusl;er allocation conf^licts 
that is» if tWo files hayeV according to their respective RIB s, 
been allotated in Whole or in part the same ^clusters .on disk. 

The po^ssi^le corribinatipns of file cluster allocatioa 
conflitts IS myriad. Onje' file may have conflicts :With only one 
other file, pne file may have conflicts with majiy other files. 
Many files may have conflicts with many files in-eUfferenrt 
combinations of numbers. 

REPAIR handles any possible combination of files with 
cluster allocation conflicts by dealing with only two. files at a 
time. As m the above example, the directory MASTER entry (and 
some additional infoimation) for a file is displayed on t:he left 
of the screen, and the directory MASTER entry (and some j , 
additional information) for a file that has cluster allocation : 
conflicts wxth It is displayed on the right of the screen,. 

■ ■■ ' . ■ /;.'■■■■ . (. 

As long as the file on the left of the screen is not 
deleted, all of the files th^t have cluster allocation conflicts 
with It will be displayed in turn on the right of the screen. 
When all of the cluster allocation conflicts with the file on the 
left of the screen have been dealt with, then the next file with 
cluster allocation conflicts will be displayed on the left of the 
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screen, anci all files that have cluster allocation conflicts with 
It will displayed m turn on the right of the screen, and so on 
until all files that have cluster allocation conflicts have Deen 
dealt with. 

The information displayed for the two files having cluster 
allocation conflicts is to guide the operator m deciding among 
the four options given Dy REPAIR. For explanation of the 
messages see 4.5.12.1 following. 

REPAIR corrects a cluster allocation conflict by deleting 
one of the files involved. If many files are involved in cluster 
allocation conflicts then the operator will probably want to 
enter "4" after each display so that he can accumulate the 
information necessary to decide which files should be deleted and 
which should be retained (that is, REPAIR will be executed twice, 
once to gather all the information about cluster allocation 
conflicts and once to actually delete files). 

Specifically, the operator has four options: 

1- Enter •' 1 " io delt^te the file indicated on the left of the 
screen; 

2. gnter "2" jLfi delete the file indicated on the right of 
the screen; 

3. Enter ^3:1 to. delete both of the files; 

4. Enter ::A1 to take ne action on either of the files and 
resume the CLUSTER ALLOCATION PHASE, PASS 3. 

4.5.12.1 Cluster allocation phase, Pass 3 Messages 

The explanations below describe the information given m the 
respective messages and how the operator can interpret the 
information. 

4.5.12.1.1 Right side of display 

PFli 000 

This message gives the PHYSICAL FILE NUMBER of the file 
whose directory MASTER entry is displayed immediately below it. 

The PFN IS a means of identifying the file Desides the 
NAME/EXTENSION given m the directory entry. Additionally, the 
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PFN of a file tells the file's relative location in the directory 
(refer to the appropriate DOS manuals for a discussion of the 
directory). This information can be useful, especially with a 
relatively new pack, in indicating which files are older and 
which are newer. 

DIRECTQfiy MASTER entry 

The directory entry for a file provides the fundamental 
means of identifying the file on the disk. The directory entry 
contains information as follows: 

The physical disk address of the beginning of the file is 
given m the first byte and the higher two digits of the second 
byte. The first byte is the cylinder address and the top three 
bits of the second byte are the cluster number (00, 10, 20 and 30 
are valid). Since the RIBs are the first two records in the 
file, this address points to the file's RIBs. 

The protection of the file is given m the bottom digit of the 
second byte. 1 or 3 = write protection, 2 = delete protection. 

The old logical record number limit field is given in the third 
(LSP) and fourth (MSP) byte of the file, as a 16-bit binary 
number. This field is currently unused by DOS.C, which normally 
sets It to zero when a file is created. 

The NAME/EXTENSION of the file is given m the 5th through 12th 
bytes and the 13th through 15th bytes respectively. 

The last byte of the directory entry is the number of the DOS 
subdirectory on that logical drive containing the file. 

1 QZ CLUSTfiRS lii file: QOQOQ 

This message gives the number of clusters in the file as a 
5-digit octal number. 

Besides giving the operator an indication of the size of the 
file. It can be compared to the number of clusters m the file 
involved in cluster allocation conflicts (below), to give a 
relative indication of what percent of the file may be m error. 

1 Q£ C0NF1.ICTINQ files: 000 

This message gives the number of files (in octal) that 
conflict with the file displayed on the left of the screen. 
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If the number is very large, ana the file not very important 
to the operator, then the operator may deciae to delete the file 
rather than look at all of the files that have cluster allocation 
conflicts with It. 

1 OF CQI^JB'LICTING CLUSTERS: OOOQQ 

This message gives the numJDer (m octal) of clusters that 
are m conflict for the entire file. If the file has conflicts 
with many files then this numJDer will almost always be larger 
than the corresponding number on the right side of the aisplay. 

The number of conflicting clusters for a file can give the 
operator, a quantitative indication of possible damage to the 
tile. 

i OF CORRECT PFIM/LRIJ: OQQQQ OF 00000 

This message gives the number of records m the file that 
have the correct DOS header information m them (being the PFW m 
the first byte of the physical record and the LRW m the second 
ana third bytes of the record) for the clusters that are in 
conflict m^th other files , and the number of recoras m the 
clusters that are m conflict. Both of the numbers are m octal. 

If a record m a contested cluster does not have the correct 
PFN/LRtvi information, then it has probably been overwritten oy a 
record of a file that also claims the cluster. 

This message gives the operator an indication of actual 
damage to the file. If the number of correct PFN/LRiM is high, 
then there is little damage to the file ana the RIB for the file 
IS probably correct. If the number of correct PFiM/LRlM is very 
low, then the file has probaDly been overwritten by another tile 
and/or the file's RIB is incorrect. 



.5.12.1.2 Right side ot scree 



n 



PFN OOP 

Same as for left siae of screen. 
DIRECTORY MASTER entry 

Same as for left siae of screen. 
£ OF CLUSTERS IN FILE: OOOQQ 



jl) 



Same as for left side of screen- 

This message provides a counter (in octal) to help the 
operator keep track of which file among several that he is 
aealmg with which the file on the left of the screen has cluster 

?r;K;2f?^i?S^''°''^^'-^^^" ^^^^ number can never exceed the 1 QZ 
QQUFhlQTmG FILES: OOP count. 

i Q£ CQt^FLIC TTNG CLUSTERS; onnnn 

This message gives the number (m octal) of clusters that 
are in conflict between the files indicated on the left and right 
or the screen. 

■1 QE. CQRRSCT PFM/LRN; QOQQO qj^ qqqqq 

This message gives the number of records in the file that 
have the correct DOS header information m them (PEN and LRN ) for 
i^ £iU^i^ iMi A££ JJQ conflict MJJ^ iiiS lii£ indicated on the 
X£li QL th& &QX^SR, and the number of records m the clusters 
that are in conflict. Both of these numbers are m octal. 

Refer to the discussion under this message for the left siae 
or the screen. 

4.5.13 Cluster allocation table replacement 
Refer to the pictogram in 4.4.13. 

The CLUSTER ALLOCATION TABLE that will be written to disk is 
a combination of the CAT for files that had no cluster allocation 
conflicts and the CAT for files that had cluster allocation 
conflicts but that the operator did not wish to delete. "^The 
allocation for files with cluster allocation conflicts is 
retained so that if a new file is created it will not take space 
that IS being used by one of the un-deleted but erroneous files, 
thus compounding cluster allocation conflicts. 

Files that will stiil exist in the directory but will not 
h^^ sj^^QR allocatecl tii thorn will be: ~^^ 

Files with an invalid RIB address m their directory MASTER 
entry; 

Files with any uncorrected error m either RIB 

The reason disk space is not allocated to these files is 
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that if REPAIR cannot fma the RIB for a file or if the RIB has 
uncorrected errors then .^r.PAIR has no way of knowing where the 
rile s clusters should be located. Any files of this class are 
best transferred to cassette (if possible) and KILLed before any 
new data is loaded to disk. 

4.5.14 Termination of REPAIR 

Refer to the pictogram m 4.4.14. 

When the REPAIR program has finished execution it goes into 
a dead loop; that is, it executes a JUMP to self. This is so 
that the processor will be "locked up" oy the REPAIR program 
until the operator takes some specific action, such as putting a 
LGO program cassette m the rear deck and depressing RESTART. 
REPAIR does not assume the DOS is loadable so it does not return 
to the DOS. If the auto-restart tab were punched out of the 
cassette m the rear deck and REPAIR executed a HALT instruction 
upon completion, then the computer would attempt to load and 
execute the cassette m the rear deck, which the operator may not 
wish to happen. 

4.5 Maximal Operator Interface 

This section discusses a variety of things that can go wrong 
on a disk pack and how REPAIR can be used to deal with those 
problems. This section is for users who are interested m 
understanding the DOS disk data structure for its own sake, with 
emphasis, of course, on ^..roblems that can occur. 

To use this section requires that the user have a copy of 
and understand the use of either of the DOS commands, DUMP or 
DUMP9380. The ability to use the Assembler will be mandatory m 
some cases. 

This section assumes that the REPAIR program is used as an 
error-fmding tool, and that the user, with the aid of one of the 
disk dump programs and special programs he may create, can fix 
errors that develop on the disk. A specific example is the case 
of a file with bad RIBs. REPAIR can tell the operator that the 
file s RIBS contain errors. Either disk dump program can be used 
to determine the magnitude of the damage to the RIBs, and, if 
necessary, where the file's records actually are on disk. It 
necessary, the user can create a simple AssemDly language program 
to re-create the file's RIBs on disk. Sometimes it will De less 
effort to re-create a file's RIBs than to re-create the file 
Itself. 
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This section follows the section numbering scheme of the two 
previous sections, MINIMAL and MEDIAL OPERATOR INTERFACE. 

V^hen a facet of REPAIR operation is discussed more 
appropriately elsewhere, the discussion is not repeated in this 
section, but the user is referred to the section containing the 
discussion. 

4.6.1 Executing REPAIR 

Refer to the discussion in 4.5.1. 

4.6.2 Sign-on and drive number specification 
Refer to the discussion in 4.5.2. 

4.6.3 Cylinder lockout 

Refer to the discussion m 4.5.3. 

If the user is not sure whether cylinders have been locked 
out on a disk (and the Lockout CAT and backup have both been 
destroyed), either of the disk dump programs can be used to look 
at the cylinders on disk. 

Cylinders that have been reserved for special use can 
generally be recognized by the formatting of their sectors. 
Sectors that have not been usea by the normal DOS routines will 
not have the special DOS header information m the first three 
bytes. The first byte is the PFN (Physical File Number) of the 
file, and the second ana third bytes give the LRN (Logical Record 
Number) of the record in the file. For records that have been 
written by the normal DOS, each cluster will have the same first 
*^jfww, iUA**« oii^ ocov^iiM Qinj uiixjLu ijyutjfci wxxi uki mcrememiea dy one 
(LSP, MSP). 

4.6.4 Directory check monitor 

Refer to the discussion in 4.5.4. 

If a page m the directory has been accidentally overwritten 
by a record from a file, then REPAIR will find many errors m 
that directory page. If while executing REPAIR the operator 
notices that there are quite a few errors in the directory, he 
can note the directory pac,e address as shown by the directory 
gJiegk monitor. (The left number of the directory check monitor 
is the physical sector number of the airectory page). Using 
either of the disk dump programs the operator can look at the baa 
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directory page(s) » 

If the damage is only to one copy of the directory (the 
usual case) then REPAIR can recover the directory. However, the 
operator may wish to use either disk dump conimand to look at the 
directory to see if, by ejamininq the data there, he can 
determine if an error m a user program has caused the directory 
to be overwritten. Clues to such events can JDe gleaned by noting 
tne tirst byte of the record (which would be a file PFN ) , for 
example* 

4. 60 5 Directory errors 

Refer to the discussion in 4»5.b and 4.6-4 above. 
4.6.t) Retrieval Information Blocks check 

Refer to the discussion m 4.5.6« 
4ob«7 Retrieval Information Blocks errors 

Refer to the discussion m 4.b.7« 

The following discussion gives an example of how the user 
can go about re-constructing one or both damaged RIBs for a file, 
only the case of complex errors (errors in the segment 
descriptors) is considered because REPAIR is capable of 
correcting simple errors. 

Complex RIB errors can come m infinitely many kinds and 
combinations^ The REPAIR diagnostics will describe specific 
errors, but if the user is considering fixing a RIB he must 
examine the RIB himself ana determine what is wrong with it and 
how to correct it. Sometimes this will involve examining records 
on disk and determining whether or not the records belong to the 
file and how they should be organized m the RIBs SEGMENT 
DESCRIPTORS. Because of the POtentJ^fll complexity of this 
operation the current version of REPAIR does not attempt the 
analysis necessary to re-construct a RIB with complex errors. 

4.6.7.1 A simple case 

A relatively simple-to-f ix case might go like this? 

1. REPAIR would find a file with simple and complex errors 

in the RIB MASTER. 
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2. The user would use either disk dump program to look at 
the RIBS and determine that the RIB MASTER had somehow been 
completely destroyed, but the format of the RIB COPY seemed to be 
correct. 

3. Using the information m the segment descriptors of the 
RIB COPY, the user would determine that the COPY was correct. 

4. The user could then use the DUMP93bO CASSETTE DUMP 
command to dump the RIB COPY to cassette, then use the DUMPi^3?0 
CASSETTE LOAD command to load the record to the RIB MASTER. 

5. The user would run REPAIR again. This time REPAIR would 
fma that the RIB MASTER for the file had one simple error, 
namely, that the LRN was incorrect. REPAIR could correct this 
error. 

6. The original error is thus corrected. 
4.6.7.2 A complex case 

The worst case of RIB damage could be corrected m the 
following manner: 

1. REPAIR would find a file with simple and complex errors 
m both the RIB MASTER and COPY. 

2. The user would use either disk dump program to look at 
the RIBS and determine that the RIBs had somehow been completely 
destroyed, but that the file following the RIBs was not damaged. 
(This can happen when a program incautiously uses DOS logical 
file 0). 

3. Using either disk dump program the user would locate and 
map all of the file's SEGMENTS on disk. 

4. From the information about the file's segments, the user 
would re-construct the file's RIBs, and write a program to write 
the RIBs to disk. 

5. As a check on the above, REPAIR would be run to insure 
that the new RIBs for the file did not indicate an allocation 
conflict with another file. 

6. The error is thus corrected. 
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4.b.b Ena of RIB check 

Refer to the discussion m 4.5.b. 
4.6.y Cluster allocation phase, Pass 1 

Refer to the discussion m 4.5.9. 

4.6.10 Cluster allocation phase, Pass 2 
Refer to the discussion m 4.5.10. 

4.6.11 Cluster allocation phase, Pass 3 
Refer to the discussion m 4.5.11 

4.6.12 Cluster allocation conflicts 

Refer to the discussion in 4.5.12. 

The user may wish to use either disk dump program to inspect 
the actual data on disk before deleting one or both of two files 
with cluster allocation conflicts. 

For a file with cluster allocation conflicts, one of five 
things may iDe true: 

1. The file may have correct RIBs and all correct records. 
(That IS, the error is in the file{s) having the cluster 
allocation conflict with this file). 

2. The file may have incorrect RIBs. 

3. The tile's space i.as been erroneously allocated to 
another file. 

4. Another file has erroneously been allocated the file's 
space. 

5. Any combination of (2), (3) and (4) above. 

Either disk dump program can be used to look at the RIBs of 
files with cluster allocation conflicts. From the information 
given by the SEGMENT DESCRIPTORS either disk dump program can be 
usea to look at where the file's records shoula be on disk. If 
the records for the file are where they should De according to 
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the RIB, then the file possibly has no errors. 

HQl^ isix. files £ii£ii SLS. Indexed PATAeug 1 files (physically 

3^^"dQf" ^cgess ^^ opposed is IME access files). ,aii ill JLhs space 
allocated ±^ ^ L2JL& will nat necessarily l^ usea . in these 
cases, some (frequently many) of the records m the file will 
never have been written and in such cases the PFN/LRN of these 
unwritten records being incorrect does not necessarily indicate 
file allocation problems. The user will need to be aware of the 
structure of the files being examined. 

From the information gathered by examination of the actual 
data on disk, the user can determine whether a file has errors 
and if so, whether corrections should be made, and if so, what 
corrections. In some cases the user may want to change a file's 
RIB to relocate the file on disk. This, of course, would require 
careful study of the real allocation of space on the disk and 
regeneration of the file's RIBs. 

4.6.13 Cluster allocation table replacement 
Refer to the discussion m 4.5.13. 

4.6.14 Termination of REPAIR 

Refer to the discussion in 4.5.14. 

4.7 All about Cylinder Lockout with REPAIR 

This chapter describes the mechanics of locking out 
cylinders. To accomplish this with the REPAIR program does not 
require an understanding of the cylinder concept. 

shoula be recorded on a sticker or label on the cover of the 
disk. In addition, the cylinders to be locked out are recorded 
internally on the disk itself m the Lockout CAT and its backup. 
Note that the example that follows indicates cylinders larger 
than the maximum number present under DOS.C, but the concept is 
what is being illustrated rather than being a precise, 
letter~for-letter example. The list of cylinders to be locked 
out might look something like: 

FLAGGED CYLINDERS (or TRACKS): 
40-50 
167 

200-202 
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The following example shows how a list of cylmaers as aDove 
would iDe locked out m the REPAIR program. 



DATAPOINT DOS.X REPAIR 



V 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS 



The screen appears as above when REPAIR is ready to accept 
cylinder lockout instructions. The instructions serve as 
additional cylinders to JDe locked out. REPAIR will not normally 
allow cylinders which have been previously locked out to be 
"unlocked". When REPAIR finishes execution and optionally 
rewrites the Lockout CATs, the cylinders locked out will be those 
originally locked out plus those specified by the operator m the 
following steps. 

To lock out cylinders, the operator must enter "Y". 



DATAPOINT DOS.X REPAIR 



\. 



DRIVE NUMBER: 
LOCKOUT cat: FORMAT LOOKS OK- 
^^'^ ARE YOU SURE ? ^^^ # 



REPAIR will make sure the operator wants to lock out 
cylinders before accepting cylinder numbers to be locked out 
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To lock out cylinders/ the operator must enter "Y". 

— ^^ 

DATAPOINT DOS.X REPAIR 



DRIVE number: 
LOCKOUT cat: FORMAT LOOKS OK. 
*** ARE YOU SURE 1 *** y 
CYLINDER NUMBER<S> <l-202>: # 



V 



The screen will appear as above when REPAIR is ready to 
accept the first cylinder (s) to be locked out. 

If the operator were locking out the cylinders listed above, 
he would enter 40-50 and press ENTER. 



DATAPOINT DOS.X REPAIR 



DRIVE NUMBER: 
LOCKOUT cat: FORMAT LOOKS OK. 
*** ARE YOU SURE ? *** Y 
CYLINDER NUMBER<S> <1~202>: 40-50 
CYLINDER NUMBER<S> <l-202>: # 
\ ______r/ 

The screen appears as above when REPAIR has accepted the 
previous cylinder lock out and is ready for the next cylinder 
number ( s) . 

According to the above sample list, the operator would now 
enter 167. 
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\. 



DRIVE NUMBER: 

LOCKOUT cat: FORMAT LOOKS OK. 
*^* ARE YOU SURE ? -^^-^ y 
CYLINDER NUMBER<S> <l'-202>: 40-50 
CYLINDER NUMBER<S> <l-202>: 167 
CYLINDER NUMBER<S> <l-202>: # 



The screen appears as above when REPAIR has accepted the 
previous lock-out and is ready to accept the next cylinder 
number ( s) . 

According to the aDove list the operator must now enter 
200-202. 



V 



DRIVE number: 

LOCKOUT CAT: FORMAT LOOKS OK. 

^^-^ ARE YOU SURE ? *** y 

CYLINDER NUMBER<S> <l-202>: 40-50 

CYLINDER NUMBER<S> <l-202>: 167 

CYLINDER NUMBER<S> <l-202>: 200-202 

CYLINDER NUMBER<S> <l-202>: # 



The screen appears as above when REPAIR has accepted the 
previous lock-out and is ready to accept the next cylinder 
number ( s) . 

According to the above example the operator has no more 
cylinders to lock out. At this point then, the operator woula 
merely depress the ENTER key to signal REPAIR that no more 
cylinders are to oe locked out- REPAIR would proceed immediately 
to the cluster allocation table and uirectory check phase- 
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4.b CAT errors and directory read/write errors 

This section describes messages displayed by the REPAIR 
program when it discovers an error (of any kind) m the CLUSTER 
ALLOCATION TABLES (CATs) or a read or write error m the 
directory. 

These errors are the first type of error checked for by 
REPAIR. A format (logic) error in one or more of the CATs is not 
fatal (will not cause REPAIR to abort), but will be noted to the 
operator. An uncorrectable read or write error in any of the 
CATS or the directory is fatal, because the disk is in very 
serious trouble if hardware errors occur m any of these tables. 

REPAIR does not consider a read error in the CAT or 
DIRECTORY fatal until either an attempt to clear the error by 
writing back to disk has failed or the operator has instructed 
REPAIR not to attempt the write. A write error to the CAT or 
DIRECTORY is always fatal. 

There is a working (MASTER) and a backup (COPY) version of 
the Working CAT, the Lockout CAT, and the directory. 

The examples that follow are given m the sequence of their 
potential occurrence in REPAIR execution. 

Important notice' Similar sequences are used for errors m 
the Lockout CAT and its backup as for the Working CAT and its 
backup. In this chapter, only the Working CAT sequence is used 
as an example, since both g re directly comparable. The messages 
for both sequences are largely identical to save space. The user 
can tell at any time whether the messa<^es refer to the Workin'" or 
Lockout CATS by looking for the header "LOCKOUT CAT:" or "WORKING 
cat:" more or less directly preceding the message. 

4.8.1 Cluster allocation table read errors 

Note that although this example concerns the CAT MASTER, the 
same messages (substituting the word COPY for MASTER) apply to 
the CAT COPY. 
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DATAPOIlNiT DOS.X REPAIR 



\. 



DRIVE number: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU VVANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

V\/ORKING cat: 

CA.T. MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? # 



The messages on the last two lines of the screen above will 
appear when the REPAIR program has detected a read error m the 
CAT MASTER. Notice how in this case, the header "WORKING CAT:" 
implies that the read erroi has occurred m the Working CAT 
MASTER as opposed to the Lockout CAT MASTER. 

To have REPAIR attempt to clear the read error enter Y; 
otherwise enter N. 



/ \ 



V 



DRIVE number: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING cat: 

CA.T. MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

READ ERROR CLEARED. 



._/ 



The message on the last line of the screen above will appear 
when the operator has replied "Y"' to the message above ana the 
attempt to clear the read error was successful. 

No further operator response is required. 
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DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITONAL CYLINDERS 

WORKING cat: 

CA.T. MASTER READ ERROR 

V^RITE TO DISK TO ATTEMPT TO CLEAR ERROR 7 N 

READ ERROR UNCORRECTABLE. 

THE PACK IS NOT FIXABLE. 



N 



The messages on the last two lines of the screen above will 
appear if the operator replies "N" to the message above or if the 
write to disk did not clear the read error. The REPAIR program 
will not accept any further commands. To get any other program 
running on the computer the operator must press the RESTART key. 

No operator response is required. 
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DRIVE NUMBER: 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS 7 N 
WORKING CAT: FORMAT LOOKS OK. 

THE CA.T. MASTER HAS DEVELOPED A READ ERROR 
THE PACK IS NOT FIXABLE. 



./ 



The messages on the last two lines of the screen above will 
appear if a read error occurs when REPAIR reads the CAT MASTER 
for the second time during the CAT check. This read error is 
automatically considered fatal because it is evidence of a 
transient hardware error m the CAT. 

No operator response is required. 
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4.b.2 Cluster Allocation TaiDle is destroyea 

Note that although this example concerns the CAT MASTER/ the 
same messages (transposing the words COPY and MASTER) apply to 
the CAT COPY. 



UATAPOINT DOS.X REPAIR 
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DRIVE NUMBER: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU V^-ANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING CAT: 

THE CA.T. [PIASTER IS DESTROYED 

WRITE CA.T. COPY INTO CA.T. MASTER ? # 



The messages on the last two lines of the screen above will 
appear when the REPAIR program has discovered that the CAT MASTER 
is destroyed but the CAT COPY appears to be valid. 

To have REPAIR copy the CAT COPY into the CAT MASTER, enter 
"Y-. Otherwise, enter "N". 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS -> "n 

WORKING CAT: 

THE CA.T. tyiASTER IS DESTROYED 

V^RITE CA.T. COPY INTO CA.T. MASTER ? Y 

DONE . 



\. 
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The message on the last line of the screen above will appear 
when the operator has replied "Y" to the message above and the 
write to the CAT MASTER was successful. REPAIR will proceed to 
check the directory (see 4.4.4). 

No operator response requirea. 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING cat: 

THE CA.T. MASTER IS DESTROYED 

WRITE CA.T. COPY INTO CA.T- MASTER ? Y 

DISK WRITE ERROR FOR CA.T. MASTER. 

THE PACK IS NOT FIXABLE. 



V 



The messages on the last two lines of the screen above will 
appear if a write error occurs when REPAIR tries to write to the 
CAT MASTER. The REPAIR program will not accept any further 
commands. To get any other program running on the computer the 
operator must press the RESTART key. 

No operator response is required. 



DRIVE number: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING CAT: 

MASTER IS DESTROYED 

MASTER & COPY ARE DESTROYED 

MASTER & COPY WILL HAVE TO BE RECONSTRUCTED FROM THE R.LB. 



THE CA.T. 
THE CA.T. 
THE CA.T. 



V 



The messages on the last three lines of the screen above 
will appear if REPAIR discovers that both copies of the CAT are 
destroyed. After the messages are displayed REPAIR will proceed 
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to check the directory (see 4.4.4). 

4.8.3 Cluster Allocation Table copies ao not match 



/ 



DATAPOINT DOS.X REPAIR 
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DRIVE tMUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU V^AWT TO LOCK OUT ADDITIONAL CYLINDERS -> N 

WORKING cat: 

CA.T. MASTER & COPY DO NOT MATCH 

THE CA.T. MASTER & COPY WILL HAVE TO BE RECONSTRUCTED FROM THE R.LB.'S 



The messages on the last two lines of the screen will appear 
when REPAIR has discovered that the CAT MASTER and COPY versions 
do not agree with each other. Since it is not possible for 
REPAIR to choose which version is correct at this point, it will 
proceed to check the DIRECTORY (see 4.4.4). 

No operator response xS required. 

4.8.4 Directory read errors 

Note that although this example concerns the directory 
MASTER, the same messages (transposing the words COPY and MASTER) 
apply to the directory COPY. 



/ 



DATAPOINT DOS.X REPAIR 
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DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING CAT: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

VJRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? # 
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The messages on the last two lines of the screen above will 
appear when REPAIR has aetectea a read error m the directory 
MASTER. 

To have REPAIR attempt to clear the read error enter "Y", 
otherwise enter "W. 



/ 



V 



DRIVE number: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS 

WORKING cat: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? # 



N 



The message on the last line of the screen above will appear 
if the operator has replied "Y" to the message above. 

To have REPAIR copy the directory COPY page to the directory 
MASTER page enter "Y", otherwise enter "N". If "N" is entered 
the directory check will continue. 



/ 



\ 



DRIVE number: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS 

WORKING cat: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? Y 

DONE. 



N 



The message on the last line of the screen above will appear 
when the write to the directory lyiASTER has been successful. The 
directory check will continue. 
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No further operator response is required. 



V 



DRIVE NUMBER: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING cat: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? Y 

DIRECTORY PAGE MASTER WRITE ERROR 

THE PACK IS NOT FIXABLE- 



The messages on the last two lines of the screen above will 
appear if the operator replied "Y" to the message above and 
REPAIR aetected a write error when it attempted to write to the 
directory MASTER. The REPAIR program will not accept any further 
commands. To get another program running on the computer the 
operator must press the RESTART key. 



No operator response is required. 



V 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING CAT: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? Y 

DIRECTORY PAGE MASTER READ ERROR 

THE PACK IS NOT FIXABLE. 



The messages of the last two lines of the screen aDove will 
appear if the operator replied "Y" to the message above ana 
REPAIR aetected a reaa error when it attemptea to re-reaa the 
directory MASTER page it haa just written. 

No operator response is required. 
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\ 
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DRIVE NUMBER: 

LOCKOUT cat: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING CAT: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? Y 

DIRECTORY COPY PAGE HAS DEVELOPED A READ ERROR 

THE PACK IS NOT FIXABLE. 



The messages on the last two lines of the screen above will 
appear if the operator replied "Y" to the message above and 
REPAIR detected a read erroi when it attempted to re-read the 
directory COPY to compare it against the directory MASTER page 
3ust written and re-read. 

No operator response is required. 



V 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS ? N 

WORKING cat: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

WRITE COPY PAGE TO MASTER PAGE ? Y 

DIRECTORY PAGE MASTER & COPY DO NOT MATCH 

THE PACK IS NOT FIXABLE. 



The messages on the last two lines of the screen above will 
appear if the operator replied -'Y" to the message above but the 
directory page MASTER and COPY did not match after the page copy 
had been made. This error is automatically considered fatal 
because it is evidence of a hardware error m the directory. 

No operator response is required. 
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DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU WANT TO LOCK OUT ADDITIONAL CYLINDERS 

WORKING cat: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? Y 

DIRECTORY PAGE COPY ALSO GIVES READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR ? # 



N 



The messages on the last two lines of the screen above will 
appear if the operator replies "Y" to the message above and 
REPAIR detects a read error m the directory COPY page. 

To have REPAIR attempt to clear the read error entery "Y", 
otherwise enter "N". if the write is successful REPAIR will 
continue with the directory check. 



V 



DRIVE NUMBER: 

LOCKOUT CAT: FORMAT LOOKS OK. 

DO YOU mm TO lock out additional cylinders -^ N 

WORKING CAT: FORMAT LOOKS OK. 

DIRECTORY PAGE MASTER READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR "^ Y 

DIRECTORY PAGE COPY READ ERROR 

WRITE TO DISK TO ATTEMPT TO CLEAR ERROR "> Y 

READ ERROR UNCORRECTABLE. 

THE PACK IS NOT FIXABLE. 



The messages on the last two lines of the screen above will 
appear if the operator replied "N" to the message above or it the 
write to disk did not clear the read error. 

No operator response is required. 
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CHAPTER b. DISK ORGANI ZATIOisl UNDER DOS . C 



This chapter descriJDes the logical organization of the data 
on the disk when operating under DOS.C and how it relates to the 
general DOS file concepts as described m the Advanced 
Programmer's Guide section of the DOS USER'S GUIDE. In this 
chapter it is assumeu that the user is familiar with the Dasic 
DOS file structuring. 

5.1 Radius spiralmg and sector skewing 

Under DOS.C, the sectors on the diskette are logically 
renumbered to allow substantially increased performance over what 
would be possible otherwise. Program loading, m particular, 
goes about three times faster than would be possible if this were 
not done. This renumbering of the sectors on the track is 
referred to as sector skewing . This sector skewing takes the 
form of placing logically sequential sectors about four sectors 
apart on a track of the diskette. Thus logical sector zero would 
appear m physical sector zero; logical sector one would appear 
m physical sector five; logical sector two would appear m 
physical sector ten; and so forth- 

In addition to rearranging the order of the sectors on a 
track of the diskette, the starting points (logical sectors zero 
on each track) do not line up along a straight-lme radius as do 
the physical sectors zero. Instead, the starting point for 
numbering sectors on a track spirals inwards. Therefore, the 
logical radius line (sectors zero, for example) forms a spiral 
on the diskette surface, and hence the term radius spiraling . 
The intention behind radius spiraling is twofold: one, it allows 
for head seek time between adjacent tracks while rapidly scanning 
through a data file (in addition to the processing time lag 
provided by the normal sector skewing) and secondly allows 
searching the directory (which is along a logical radius of the 
diskette, as will De described later) about three times faster 
than would otherwise occur. Together with sector skewing, radius 
spiraling aius m achieving much higher overall system 
performance than is obtainable on most competitive aiskette based 
systems. 
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5.2 Size of a diskette 

There are 77 tracks on a diskette, each of which contains 
thirteen 25fa-byte sectors. This yields a total of 1001 sectors, 
or a grand total of 256,256 bytes of storage capacity. The first 
track on the diskette (the one nearest the edge ' of the diskette) 
is not used by DOS.C, m order to help provide compatibility with 
IBM equipment. Additionally, the logical last sector on each 
track (sector 12 if one counts starting at 0) is not used by 
DOS.C for data, for reasons which will be described in subsequent 
sections. Subtracting these two unallocatable areas results m a 
total allocatable file space of 912 sectors. About ninety 
sectors of these are used by the DOS for its system files, 
leaving about b25 sectors for user files, a user file capacity of 
over 200,000 bytes. This constitutes about twice the capacity of 
a tape cassette on each diskette. Due to the higher data storage 
efficiency attained by Datapomt software, most users will fma 
that the total number of records storea on a Datapomt format 
diskette will be as large as, and m most cases substantially 
larger than, the number achieved on competitive systems. 

5.3 Cluster mapping 

Under DOS.C, each track of the diskette consists of 4 
clusters of three sectors each. This implies that one cluster or 
three sectors is the smallest allocatable unit of space on a 
diskette, and that all files are multiples of three sectors m 
length. 

In the cluster allocation table, the four clusters on each 
track are represented by the low-order four bits of each byte. 
As m other Datapomt DOS, a one bit represents that the 
corresponding cluster is allocated and a zero bit indicates that 
the corresponding cluster is unavailable for allocation. The 
high-order four bits of each byte in the CATs are reserved for 
future use m DOS.C, and are currently always set to zero. 

5.4 Segments under DOS.C 

The use of a three sector cluster has numerous aavantages on 
the diskette. One which should be immediately apparent is that 
the amount of space wastea due to always allocating an integral 
number of clusters is reduced to only an average of one and a 
half sectors per file. Perhaps a less obvious advantage results 
from the manner m which the Datapoint DOS allocate disk space to 
files. During space allocation, the DOS will allocate the first 
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contiguous, maximum- size segment it can fina as an initial (or 
seconuary for that matter) allocation- Since a segment consists 
of 32 clusters (there are five bits of cluster number information 
m each segment descriptor) / this results m files being 
initially allocatea 3b sectors, assuming that the space on the 
uiskette is sufficiently unfragmentea to allow such an 
allocation. Making this initial allocation smaller than the 132 
and 240 sectors as used m some of the other Datapomt DOS allows 
tor several scratch files to be opened on a diskette which 
already has a few files on it, as each newly opened file will 
take a smaller bite out of that portion of space remaining 
unallocated. Making the full segment size much smaller than 36 
sectors quickly increases the amount of overhead required to 
index through the file (since the number of RIB accesses required 
increases) and decreases performance. 

b.b Maximum file size 

Under DOS.C, the maximum file size attainable depends upon 
the amount of space used on the diskette for system files, but 
using the current size of DOS-C as an example indicates that at 
least bOO sectors should be available for user file allocation on 
a normal data file diskette. Users having only a single diskette 
drive anu therefore having several programs on the diskette m 
addition to the DOS will have a corresponding reduction in the 
maximum size of data files they may have. Users whose files 
exceed the capacity of one diskette will need to segment their 
files at the user program level much as they would do on a 
cassette system when a file exceeded the capacity of a single 
cassette. 

5.6 Cluster Allocation Table and Directory 

Under DOS.C, the use of four three-sector clusters per track 
results m one unused sector per track. This restriction arises 
from the facts that (1) all clusters under Datapomt DOS must 
contain the same number of sectors and that no cluster may span a 
track boundary; and (2) a 13-sector cluster is not practical 
because it results in excessive amounts of wasted space at the 
end of each file on the diskette. Since these 7b sectors on the 
diskette (remember that track zero is not used) are not availaDle 
for allocation as file space, they are partially put to use for 
storage of DOS system taoles: four cluster allocation table 
sectors and thirty two directory sectors. These system tables 
are positioned m the following manner: 

Track - Unused; for IBM compatibility 
Tracks 1-lb - Directory copy, for backup purposes 
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Tracks 17-32 - Primary DOS directory 

Track 33 - Working Cluster Allocation Table 

Track 34 - Working Cluster Allocation Table backup 

Track 35 - Lockout Cluster Allocation Table 

Track ^ 36 - Lockout Cluster Allocation Table backup 

Tracks 37-76 - Reservea for future DOS use 

Again recall that each of the above sectors is m logical 
sector 12 of the track indicated. 

In the directory, the RIB address field is organizea in the 
same manner as a DOS-C standard physical disk address. The most 
significant byte is the most significant byte of the physical 
disk address, exactly as would be in the D register on entry to 
DRJ>. The less significant byte contains the least significant 
byte of the physical disk address, except that since the primary 
RIB IS always the first sector m a cluster the least significant 
bits of this byte are used as protection indicators for the file 
(rather than a sector number withm the cluster maicatea by the 
most significant two bits). 

The field m each 16-byte directory entry that was used as a 
maximum file length limit field in the old DOS 1.2 is not used by 
DOS.C and under DOS.C is always initially set to zeros. 

The last byte of each directory entry is the subdirectory 
number, corresponding to the number (m binary) that is displayed 
by the SUR command immediately following the name of each of the 
indicated subdirectories on the indicated drives. 

In the Cluster Allocation Tables, bytes 23i^-254 are used for 
the Directory_ Mapping bytes. These sixteen bytes each contain 
either an 0377 or thp» nnmhe-r o"f^ -Fii^c <-.ii-vvc>'^-*-T" -.tt^^-.^^^ .^ ji-u-. 

corresponding one of the sixteen directory sectors. These bytes 
are updated automatically by the DOS whenever a file is created 
or deleted, and are upoated by the DOS occasionally if they are 
found to be inaccurate. The purpose of these directory mapping 
bytes is to provide improved speed of directory lookups and to 
allow faster creation of files. They are of the greatest benefit 
to users who have several drives m their system where relatively 
few files exist on each drive. The intention is to eliminate the 
need to read m directory sectors while looking for a file if 
those sectors are known to not contain any active directory 
entries, and likewise when looking for an empty slot for use by a 
new file to eliminate having to read sectors known to have all 
sixteen directory entries m use. 
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CHAPTER 6. INTERNAL DOS PARAMETERIZATION 



This section descriJDes the DOS- dependent aetails of the 
parameterization ot DOS-C system routines. 

6.1 Physical disk address format 

Under DOS-C, physical disk addresses are represented m 
a two-byte format in a manner quite similar to that used 
under the other DOS. The most significant JDyte (which is 
traditionally placed m the D register) is the cylinder 
numDer, just like for DOS-A and DOS.B. The less significant 
byte (usually placed m the E register) has its most 
significant two bits representing a cluster number within 
the track (all combinations of these two bits are valid 
since there are four clusters per track) and the least 
significant two bits representing the sector number withm 
the specified cluster. Because there are only three sectors 
per cluster, only binary values 00, 01 and 10 are valid for 
these low-order bits. (The only exception to this rule is 
that a least significant PDA byte of 0303 permits access to 
the unallocatable sector on each track, that sector used for 
system table sectors). (For compatibility reasons, the most 
significant three Dits can be considered the cluster number, 
yielding clusters numbered 0, 2, 4, and 6). This format has 
several sizeable advantages over the format useu by old DOS 

1.2 from the standpoint of uniformity among various system 
data Items, easier internal address conversions (between, 
for example, segment descriptors m a e RIB and physical 
disk addresses), and easier internal computation of 
sequential sectors within the current segment. 

The unused bits of the least significant physical disk 
address byte (that is, the center four bits) should always 
be set to zero. 



b-1 



